edf2csv 0.7.210 → 0.7.212

package/dist/convert/run.js

@@ -540,21 +540,6 @@ async function writeSignalFiles(file, plan, outputDir, recordStarts, options, on
 function nearlyEqual(a, b) {
     return Math.abs(a - b) <= Math.max(Math.abs(a), Math.abs(b)) * 1e-12;
 }
-/** The chosen instant as it will be written, for deciding which channels share it. */
-function formatAt(open, cursors, recordStart, earliest) {
-    for (let g = 0; g < open.length; g++) {
-        const entry = open[g];
-        if (!entry)
-            continue;
-        const sample = cursors[g] ?? 0;
-        if (sample >= entry.group.samplesPerRecord)
-            continue;
-        if (recordStart + sample / entry.group.rate === earliest) {
-            return entry.formatTime(recordStart, sample);
-        }
-    }
-    return '';
-}
 async function writeLongRecord(file, open, batch, recordInBatch, recordStart, range) {
     const writer = open[0]?.writer;
     if (!writer)
@@ -564,6 +549,8 @@ async function writeLongRecord(file, open, batch, recordInBatch, recordStart, ra
     const due = [];
     for (;;) {
         let earliest = Infinity;
+        let source = -1;
+        let sourceSample = 0;
         for (let g = 0; g < open.length; g++) {
             const entry = open[g];
             if (!entry)
@@ -572,8 +559,11 @@ async function writeLongRecord(file, open, batch, recordInBatch, recordStart, ra
             if (sample >= entry.group.samplesPerRecord)
                 continue;
             const time = recordStart + sample / entry.group.rate;
-            if (time < earliest)
+            if (time < earliest) {
                 earliest = time;
+                source = g;
+                sourceSample = sample;
+            }
         }
         if (earliest === Infinity)
             return;
@@ -596,7 +586,15 @@ async function writeLongRecord(file, open, batch, recordInBatch, recordStart, ra
           definition a reader of the CSV can apply. The numeric pre-filter keeps the common case
           to one comparison; formatting happens only for candidates already within a hair.
         */
-        const earliestText = formatAt(open, cursors, recordStart, earliest);
+        let earliestText = null;
+        /*
+          Formatted on the first near-tie and not before, which on a single-rate table is never.
+    
+          The group and sample that set `earliest` are captured above rather than searched for
+          again, since the loop below advances cursors as it goes and a later search would be
+          looking at a table that had already moved on.
+        */
+        const asWritten = () => (earliestText ??= open[source]?.formatTime(recordStart, sourceSample) ?? '');
         due.length = 0;
         for (let g = 0; g < open.length; g++) {
             const entry = open[g];
@@ -610,7 +608,7 @@ async function writeLongRecord(file, open, batch, recordInBatch, recordStart, ra
                 // Far away in the ordinary case; only a near-tie is worth formatting.
                 if (!nearlyEqual(time, earliest))
                     continue;
-                if (entry.formatTime(recordStart, sample) !== earliestText)
+                if (entry.formatTime(recordStart, sample) !== asWritten())
                     continue;
             }
             cursors[g] = sample + 1;

package/dist/convert/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/convert/run.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Executing a conversion.\n *\n * Everything is written in a single pass over the data records. All rate groups are\n * open at once and fed from the same batch of bytes, so a file is read once no\n * matter how many output tables it produces, and memory stays flat.\n */\n\nimport { createWriteStream, fstatSync } from 'node:fs';\nimport { mkdir, readdir, stat, writeFile } from 'node:fs/promises';\nimport { finished } from 'node:stream/promises';\nimport type { Writable } from 'node:stream';\nimport { createGzip, gzipSync } from 'node:zlib';\nimport path from 'node:path';\n\nimport type { RecordBatch } from '../edf/reader.js';\nimport { EdfFile } from '../edf/reader.js';\nimport { describeFormat, formatRates, formatWallClock } from '../edf/header.js';\nimport type { Diagnostic } from '../edf/errors.js';\nimport { EdfError } from '../edf/errors.js';\nimport type { Annotation } from '../edf/annotations.js';\nimport {\n  BufferedLineWriter,\n  DEFAULT_FLUSH_THRESHOLD,\n  UTF8_BOM,\n  csvRow,\n  escapeCsvField,\n} from '../format/csv.js';\nimport { listed } from '../format/list.js';\nimport {\n  makeSampleFormatter,\n  makeTimeFormatter,\n  newOffsetBudget,\n  newSampleCacheBudget,\n  plain,\n} from '../format/number.js';\nimport type { SampleFormatter } from '../format/number.js';\nimport { TIME_COLUMN } from './channels.js';\nimport { assertInputPath } from './options.js';\nimport { buildPlan, withoutFileRateWarning } from './plan.js';\nimport type { ConversionPlan, PlanOptions, RateGroup } from './plan.js';\nimport { deriveRecordStarts, withTimingPromiseKept } from './timing.js';\nimport { sampleTimeIsInRange, toleranceFor } from './time-range.js';\nimport { VERSION as TOOL_VERSION } from '../version.js';\n\nexport { TOOL_VERSION };\n\nexport type ConversionErrorCode =\n  | 'OUTPUT_EXISTS'\n  | 'OUTPUT_UNWRITABLE'\n  | 'INPUT_OUTPUT_COLLISION'\n  | 'INPUT_UNREADABLE'\n  | 'UNSUPPORTED_REQUEST'\n  | 'CALLBACK_FAILED'\n  | 'WRITE_FAILED';\n\n/**\n * Codes that mean the command cannot be carried out as written, rather than that something\n * about the file or the destination went wrong.\n *\n * The distinction is the one the exit codes draw: 1 is \"the file or the destination is the\n * problem\", 2 is \"the command line is the problem\". A caller with a `--stdout` conflict is\n * being told to change the flags — the hints say exactly that — so filing it under 1 sent\n * scripts looking at the disk. Exit 2 already covers checks that need the header first,\n * such as a `--channels` term matching nothing.\n */\nexport const USAGE_ERROR_CODES: ReadonlySet<ConversionErrorCode> = new Set(['UNSUPPORTED_REQUEST']);\n\nexport class ConversionError extends Error {\n  readonly code: ConversionErrorCode;\n  readonly hint: string | undefined;\n  constructor(code: ConversionErrorCode, message: string, hint?: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ConversionError';\n    this.code = code;\n    this.hint = hint;\n  }\n}\n\nexport interface ConvertOptions extends PlanOptions {\n  /**\n   * Destination directory. Defaults to `defaultOutputDir(inputPath)`: the input's name with\n   * its extension replaced by `_csv`, beside the input — `sleep-study.edf` gives\n   * `sleep-study_csv`, not `sleep-study`.\n   */\n  outputDir?: string | undefined;\n  /** Overwrite an existing output directory. */\n  force?: boolean | undefined;\n  /** Record a SHA-256 of the input in metadata.json. Costs one extra read of the file. */\n  checksum?: boolean | undefined;\n  /**\n   * Write the signal CSV to stdout instead of to a directory.\n   *\n   * Only valid when the conversion produces exactly one signal file. In the default wide\n   * layout a mixed-rate recording becomes several tables, and merging them into one stream\n   * would mean inventing the samples this tool exists not to invent; `layout: 'long'` gives\n   * one table for any recording, so it lifts the restriction. No sidecar files are written.\n   */\n  toStdout?: boolean | undefined;\n  onProgress?: ((progress: ConversionProgress) => void) | undefined;\n}\n\nexport interface ConversionProgress {\n  recordsDone: number;\n  recordsTotal: number;\n  bytesWritten: number;\n}\n\nexport interface WrittenFile {\n  name: string;\n  rows: number;\n}\n\nexport interface ConvertResult {\n  outputDir: string;\n  files: WrittenFile[];\n  /**\n   * True when a `--stdout` reader closed the pipe before the conversion finished.\n   *\n   * `edf2csv rec.edf --stdout | head -1` is an ordinary thing to type and not a failure, but\n   * it is also not a conversion: the row count is rows formatted before the close was\n   * noticed, which is neither the recording's total nor what the reader received.\n   */\n  readerHungUp: boolean;\n  annotationCount: number;\n  diagnostics: Diagnostic[];\n  plan: ConversionPlan;\n  file: EdfFile;\n  elapsedMs: number;\n}\n\ninterface OpenGroup {\n  group: RateGroup;\n  writer: BufferedLineWriter;\n  formatters: SampleFormatter[];\n  formatTime: (recordStart: number, sample: number) => string;\n  rows: number;\n  /** Resolves once a compressed stream's bytes have reached the file behind it. */\n  settled: Promise<void>;\n  /** Detaches the compressor's error forwarding from a stream this tool does not own. */\n  release: () => void;\n}\n\nexport async function convert(inputPath: string, options: ConvertOptions = {}): Promise<ConvertResult> {\n  assertInputPath(inputPath);\n  const startedAt = Date.now();\n  const file = await EdfFile.open(inputPath);\n\n  try {\n    /*\n      Hashed before a record is read, and only published if the file held still.\n\n      A checksum taken afterwards cannot be trusted whichever descriptor it goes through. A\n      file overwritten in place keeps its inode, so the open handle sees the new bytes too,\n      and the old ones are simply gone — there is nowhere left to read what was converted.\n      Taking it first at least means the hash describes the file the header was read from.\n\n      What makes it a guarantee rather than a hope is the check at the end: if size or\n      modification time moved at any point, the hash is dropped and the run says why. So\n      `sha256` present means the file demonstrably did not change while it was read, and a\n      recording still being written gets a null and a warning instead of a plausible hash of\n      the wrong bytes. (A change reverted within the same modification timestamp would slip\n      through; nothing short of copying the input first can close that.)\n    */\n    const checksumAtOpen = options.checksum === true ? await file.sha256() : null;\n\n    // One pass over the annotation channel supplies everything annotation-related:\n    // where each record sits in time, and the full event list. It reads the whole\n    // file even when a window was requested, because an annotation inside the window\n    // may be stored in a record outside it.\n    const annotationData =\n      file.annotationSignals.length > 0\n        ? await file.readAnnotations()\n        : { annotations: [] as Annotation[], recordStarts: [] as (number | null)[], malformed: 0 };\n\n    const timing = deriveRecordStarts(file, annotationData);\n\n    const plan = buildPlan(\n      {\n        signals: file.header.signals,\n        recordDuration: file.header.recordDuration,\n        recordCount: file.recordCount,\n        hasAnnotationChannel: file.annotationSignals.length > 0,\n        recordStarts: timing.starts,\n      },\n      options,\n    );\n    plan.diagnostics.push(...timing.diagnostics);\n\n    if (options.toStdout === true) {\n      const refusal = stdoutRefusal(file, plan);\n      if (refusal) throw refusal;\n      let readerHungUp = false;\n      const written = await writeSignalFiles(file, plan, null, timing.starts, options, (hungUp) => {\n        readerHungUp = hungUp;\n      });\n      if (await file.changedSinceOpen()) plan.diagnostics.push(inputChanged(false));\n      return {\n        outputDir: '-',\n        files: written,\n        readerHungUp,\n        annotationCount: 0,\n        diagnostics: [...withTimingPromiseKept(withoutFileRateWarning(file.diagnostics), timing.starts !== null), ...plan.diagnostics],\n        plan,\n        file,\n        elapsedMs: Date.now() - startedAt,\n      };\n    }\n\n    /*\n      A destination whose last component is `.` or `..` does not name a directory of its own.\n\n      `prepareOutputDir` claims the final component with a single non-recursive mkdir, having\n      created its parents recursively — which is what makes two conversions racing for one\n      directory safe. `path.dirname(\"out/.\")` is `\"out\"`, so for these the parent step creates\n      the destination itself and the claim then asks the filesystem to make `.` inside it,\n      which always exists. The result was a refusal naming a directory this same run had just\n      made, one line after making it:\n\n          edf2csv rec.edf --out ./fresh/.\n          error: \"./fresh/.\" already exists.\n                 Pass --force to overwrite it, or --out to choose a different directory.\n\n      Exit 1, nothing converted, and an empty `fresh/` left on disk. `--force` does not help:\n      the claim fails the same way whatever it is told, so the path was unusable rather than\n      occupied.\n\n      Normalised only in that case, so `--out ./converted` keeps the spelling it was given —\n      that one is already how the directory is found on disk, which is what `output_dir`\n      promises, and rewriting it to `converted` would churn every example for no gain.\n    */\n    const asked = options.outputDir ?? defaultOutputDir(inputPath);\n    const outputDir = /(?:^|[\\\\/])\\.\\.?$/u.test(asked) ? path.normalize(asked) : asked;\n    await assertInputDoesNotOverlapOutputs(inputPath, outputDir, file, plan, options);\n    await prepareOutputDir(outputDir, options.force === true);\n\n    const written: WrittenFile[] = [];\n\n    if (plan.writeSignals && plan.groups.length > 0) {\n      const signals = await writeSignalFiles(file, plan, outputDir, timing.starts, options);\n      written.push(...signals);\n    } else {\n      const missing = noSignalFile(file, plan);\n      if (missing) plan.diagnostics.push(missing);\n    }\n\n    const noEvents = noAnnotations(file, options);\n    if (noEvents) plan.diagnostics.push(noEvents);\n\n    let annotationsWritten = 0;\n    if (file.annotationSignals.length > 0) {\n      const window = requestedAnnotationWindow(options, plan.range.recordingStartSeconds);\n      // Reported against the rows that will be written, not against the file; see\n      // durationDiagnostics.\n      plan.diagnostics.push(...durationDiagnostics(annotationData.annotations, window));\n      const result = await writeAnnotationsCsv(\n        outputDir,\n        annotationData.annotations,\n        window,\n        options.gzip === true,\n        options.bom === true,\n      );\n      written.push(result);\n      annotationsWritten = result.rows;\n    }\n\n    written.push(\n      await writeChannelsCsv(outputDir, file, plan, options.gzip === true, options.bom === true),\n    );\n\n    /*\n      The file moved under the conversion. Said out loud, because nothing else shows it.\n\n      The CSVs are still correct for the records that were read, and metadata.json still\n      describes the file as it was opened — so the record is consistent with the output\n      whatever happens here. What stops being true is that the checksum describes the bytes\n      that were converted, since an in-place overwrite leaves nowhere to read them from. It\n      is dropped rather than guessed at.\n    */\n    const changed = await file.changedSinceOpen();\n    if (changed) plan.diagnostics.push(inputChanged(options.checksum === true));\n\n    await writeMetadata(\n      outputDir,\n      inputPath,\n      file,\n      plan,\n      written,\n      annotationsWritten,\n      changed ? null : checksumAtOpen,\n      timing.starts !== null,\n    );\n\n    const stale = await findStaleOutput(outputDir, written);\n\n    return {\n      outputDir,\n      files: written,\n      readerHungUp: false,\n      annotationCount: annotationsWritten,\n      diagnostics: [...withTimingPromiseKept(withoutFileRateWarning(file.diagnostics), timing.starts !== null), ...plan.diagnostics, ...stale],\n      plan,\n      file,\n      elapsedMs: Date.now() - startedAt,\n    };\n  } finally {\n    await file.close();\n  }\n}\n\n/*\n  Files this tool produces, used to spot leftovers from an earlier conversion.\n\n  The rate part has to allow every shape a filename can now take, not just the plain ones:\n\n    signals_256hz.csv         an integer rate\n    signals_12_5hz.csv        a fractional rate, decimal point written as an underscore\n    signals_1_000e-7hz.csv    a rate small enough to need exponent form  (0.2.2)\n    signals_256hz.csv.gz      any of the above, compressed                (0.3.0)\n    signals_0hz_2.csv         a second group whose rate slug collided    (0.2.1)\n\n  The previous `[\\w.]+hz` matched neither of the last two — `-` and `+` are not word\n  characters, and the collision suffix falls after the `hz`. Both were introduced by\n  recent changes and both silently stopped being recognised as this tool's own output, so\n  leftovers of exactly those kinds went unreported: the one situation the warning exists\n  for. Requiring a digit after the underscore keeps a user's own `signals_notes.csv` out.\n*/\nconst OUTPUT_PATTERN =\n  /^(signals(_\\d[\\w.+-]*hz(_\\d+)?)?\\.csv(\\.gz)?|annotations\\.csv(\\.gz)?|channels\\.csv(\\.gz)?|metadata\\.json)$/u;\n\n/**\n * Detect output from a previous run that this one did not replace.\n *\n * `--force` overwrites files but does not empty the directory, so converting a\n * mixed-rate recording and then a single-rate one into the same place leaves\n * `signals_256hz.csv` sitting next to a fresh `signals.csv`. Both look current.\n * Nothing is deleted here — the user is told, and decides.\n */\nasync function findStaleOutput(\n  outputDir: string,\n  written: readonly WrittenFile[],\n): Promise<Diagnostic[]> {\n  const entries = await readdir(outputDir).catch(() => null);\n  if (!entries) return [];\n\n  // metadata.json is rewritten on every run but is not part of the reported file list.\n  const fresh = new Set([...written.map((f) => f.name), 'metadata.json']);\n  const stale = entries.filter((name) => OUTPUT_PATTERN.test(name) && !fresh.has(name)).sort();\n  if (stale.length === 0) return [];\n\n  return [\n    {\n      code: 'STALE_OUTPUT',\n      severity: 'warning',\n      /*\n        Through `listed`, like every other message that enumerates something this run does not\n        control. How many stale files a directory holds is up to the directory, and a\n        mixed-rate recording converted into a reused one is exactly how it fills up: 120 old\n        `signals_<rate>hz.csv` files produced a single 2,373-character warning line. That is\n        the failure `listed` was written for — its own comment quotes the 1,600-character\n        version of it — and this was the one message still joining its own list.\n\n        The hint said \"Delete them\" whatever the count, so one stale file read \"signals_999hz\n        .csv is left over ... Delete them.\"\n      */\n      message:\n        `${listed(stale)} ${stale.length === 1 ? 'is' : 'are'} left over from an earlier ` +\n        `conversion into this directory and ${stale.length === 1 ? 'was' : 'were'} not rewritten.`,\n      hint:\n        `Delete ${stale.length === 1 ? 'it' : 'them'}, or convert into a fresh directory, so ` +\n        'the two runs do not get mixed up.',\n    },\n  ];\n}\n\nexport function defaultOutputDir(inputPath: string): string {\n  const base = path.basename(inputPath, path.extname(inputPath));\n  return path.join(path.dirname(inputPath), `${base}_csv`);\n}\n\n/** Never let an output target resolve to the recording being read, even with --force. */\nasync function assertInputDoesNotOverlapOutputs(\n  inputPath: string,\n  outputDir: string,\n  file: EdfFile,\n  plan: ConversionPlan,\n  options: ConvertOptions,\n): Promise<void> {\n  /*\n    The names this run will actually write, compressed ones included.\n\n    The rate files come from the plan and already carry `.csv.gz` under --gzip; the sidecars\n    were spelled out here and did not. So a compressed run checked two names it would never\n    write and missed the two it would: a recording sitting at <outdir>/channels.csv.gz was\n    overwritten by its own conversion, with --force, reported as a success. The same file\n    named signals.csv.gz was refused, which is what gives the oversight away.\n  */\n  const suffix = options.gzip === true ? '.csv.gz' : '.csv';\n  const names = new Set(plan.groups.map((group) => group.fileName));\n  if (file.annotationSignals.length > 0) names.add(`annotations${suffix}`);\n  names.add(`channels${suffix}`);\n  names.add('metadata.json');\n\n  const inputResolved = path.resolve(inputPath);\n  const inputInfo = await stat(inputPath);\n\n  for (const name of names) {\n    const target = path.join(outputDir, name);\n    const targetResolved = path.resolve(target);\n    const targetInfo = await stat(target).catch(() => null);\n    const samePath = targetResolved === inputResolved;\n    const sameFile =\n      targetInfo !== null && targetInfo.dev === inputInfo.dev && targetInfo.ino === inputInfo.ino;\n    if (!samePath && !sameFile) continue;\n\n    throw new ConversionError(\n      'INPUT_OUTPUT_COLLISION',\n      `Output file \"${target}\" is the same file as the input recording.`,\n      'Choose a separate directory with --out. The input was not modified.',\n    );\n  }\n}\n\nasync function prepareOutputDir(dir: string, force: boolean): Promise<void> {\n  /*\n    Claim the directory with a single atomic mkdir rather than asking whether it exists\n    and then creating it.\n\n    Checking first left a window between the two: two conversions started together both\n    saw \"not there\", both proceeded, and both opened write streams on the same signals.csv.\n    Neither reported anything — both exited 0, having half-written one file between them.\n    A non-recursive mkdir cannot do that. Exactly one caller creates the directory; every\n    other one gets EEXIST from the filesystem and takes the already-exists path below.\n\n    Parents are still created recursively, since --out ./a/b/c should work. Only the final\n    component is the claim.\n  */\n  const parent = path.dirname(dir);\n  if (parent && parent !== dir) {\n    try {\n      await mkdir(parent, { recursive: true });\n    } catch (cause: unknown) {\n      // A parent that is a regular file surfaces as EEXIST naming the parent, which reads\n      // as though the destination already exists rather than as \"you cannot put a\n      // directory inside a file\". Name the real obstacle instead of the errno.\n      const info = await stat(parent).catch(() => null);\n      if (info && !info.isDirectory()) {\n        throw new ConversionError(\n          'OUTPUT_UNWRITABLE',\n          `Cannot create \"${dir}\": \"${parent}\" is a file, not a directory.`,\n          'Choose a destination whose parent directories are directories, with --out.',\n        );\n      }\n      throw new ConversionError(\n        'OUTPUT_UNWRITABLE',\n        `Cannot create \"${dir}\": ${describeFsError(cause)}.`,\n        'Check the path exists and that you have permission to write there.',\n      );\n    }\n  }\n\n  let claimed = true;\n  try {\n    await mkdir(dir);\n  } catch (cause: unknown) {\n    if ((cause as NodeJS.ErrnoException).code !== 'EEXIST') {\n      throw new ConversionError(\n        'OUTPUT_UNWRITABLE',\n        `Cannot create \"${dir}\": ${describeFsError(cause)}.`,\n        'Check the path exists and that you have permission to write there.',\n      );\n    }\n    claimed = false;\n  }\n\n  if (!claimed) {\n    const existing = await stat(dir).catch(() => null);\n\n    // --force means \"replace my previous output\", not \"write output files into\n    // whatever this happens to be\". Pointing it at a regular file needs saying so.\n    if (existing && !existing.isDirectory()) {\n      throw new ConversionError(\n        'OUTPUT_UNWRITABLE',\n        `\"${dir}\" is a file, but the converted data needs a directory.`,\n        'Choose a directory with --out.',\n      );\n    }\n    if (!force) {\n      throw new ConversionError(\n        'OUTPUT_EXISTS',\n        `\"${dir}\" already exists.`,\n        'Pass --force to overwrite it, or --out to choose a different directory.',\n      );\n    }\n  }\n}\n\n/** Turn a Node filesystem error into something a person can act on. */\nfunction describeFsError(cause: unknown): string {\n  const code = (cause as NodeJS.ErrnoException | undefined)?.code;\n  if (code === 'EACCES' || code === 'EPERM') return 'permission denied';\n  if (code === 'ENOSPC') return 'the disk is full';\n  // The one that actually happens on a shared filesystem, and the one this list left out.\n  if (code === 'EDQUOT') return 'you are over your disk quota on this filesystem';\n  if (code === 'ENOTDIR') return 'part of the path is a file, not a directory';\n  if (code === 'EROFS') return 'the filesystem is read-only';\n  if (code === 'ENAMETOOLONG') return 'the path is too long';\n  /*\n    The one this list could not describe, and the recursive mkdir above is what makes it\n    surprising: every parent is created on the way, so \"no such file or directory\" is not a\n    parent that was missing. It is a component that exists and leads nowhere — a symbolic\n    link with no target is the way to get one — or a directory removed by something else\n    between the two calls.\n\n    Missing it meant the fallback ran, which is Node's own text, complete with the internal\n    call that raised it:\n\n        error: Cannot create \"dangle/x\": ENOENT: no such file or directory, mkdir 'dangle'.\n               Check the path exists and that you have permission to write there.\n\n    Keeping that off the screen is the whole purpose of the six lines above it.\n  */\n  if (code === 'ENOENT') return 'part of the path does not exist';\n  return cause instanceof Error ? cause.message : String(cause);\n}\n\nasync function writeSignalFiles(\n  file: EdfFile,\n  plan: ConversionPlan,\n  outputDir: string | null,\n  recordStarts: Float64Array | null,\n  options: ConvertOptions,\n  onHangUp?: (hungUp: boolean) => void,\n): Promise<WrittenFile[]> {\n  // One budget for every table in this conversion, not one per table: see OffsetBudget.\n  const offsets = newOffsetBudget();\n  // Likewise one for every channel, not one per channel: see SampleCacheBudget.\n  const sampleCaches = newSampleCacheBudget();\n  // Only the stdout path needs this; --out finds a full disk on its own, because it always\n  // has another file to write afterwards. See auditStdout.\n  const audit = outputDir === null ? auditStdout() : null;\n  /*\n    In the long layout every group writes into one table, so they share one stream. Opening\n    a stream per group on the same path is what the rate-slug collision fix in groupByRate\n    was about: two writers on one file interleave rows under a header naming one of them.\n  */\n  let shared: {\n    stream: Writable;\n    settled: Promise<void>;\n    release: () => void;\n    target: Writable;\n    writer: BufferedLineWriter;\n  } | null = null;\n\n  /*\n    One buffer's worth of memory for the conversion, not one per table.\n\n    Every group had its own writer at the default 1 MiB threshold, so pending output was\n    group count × 1 MiB before anything drained. A 6.5 MB recording with 40 sampling rates\n    — the header allows thousands of channels, and a research montage really does mix a\n    dozen rates — died with a raw V8 heap out-of-memory and exit 134 under a 96 MB cap,\n    while the site advertises 48 MB. The recording is small; it is the fan-out that is not.\n\n    Split evenly with a floor, so the single-rate case, which is nearly every recording,\n    keeps exactly the buffer it always had, and forty tables cost one megabyte between them\n    rather than forty. The floor is what the sum is bounded by rather than the split: past\n    128 groups every table takes the 8 KiB minimum, so the total grows again from there.\n    The long layout shares one writer already and is unaffected either way.\n  */\n  const MIN_FLUSH_THRESHOLD = 8 * 1024;\n  const flushThreshold = Math.max(\n    MIN_FLUSH_THRESHOLD,\n    Math.floor(DEFAULT_FLUSH_THRESHOLD / Math.max(1, plan.groups.length)),\n  );\n  /*\n    The stream's own buffer is the other half of the same sum.\n\n    0.5.6 shared the line-buffer budget and left `createWriteStream` at its 64 KiB default,\n    which is per stream: 200 rate groups meant 12.8 MB of stream buffer on top of 12.8 MB of\n    line buffer, and an 855 KB recording still died at a 48 MB cap. Shared the same way, with\n    a floor that keeps an ordinary conversion writing in useful-sized pieces.\n  */\n  const streamBuffer = Math.max(\n    16 * 1024,\n    Math.floor(DEFAULT_FLUSH_THRESHOLD / Math.max(1, plan.groups.length)),\n  );\n\n  const open: OpenGroup[] = plan.groups.map((group, groupIndex) => {\n    // A null directory means the single table goes to stdout. process.stdout is already a\n    // writable stream, so the same buffered writer and backpressure handling apply.\n    const target =\n      shared?.target ??\n      (outputDir === null\n        ? process.stdout\n        : createWriteStream(path.join(outputDir, group.fileName), {\n            highWaterMark: streamBuffer,\n          }));\n    const { stream, settled, release } = shared ?? compressed(target, options.gzip === true);\n    /*\n      Under --gzip the writer feeds the compressor, so its byte count is the CSV before\n      compression and says nothing about what reached the descriptor. The compressor's own\n      output is what stdout is handed, so that is what is counted. `pipe` uses a 'data'\n      listener of its own and a second one is delivered the same chunks.\n\n      Once per stream, which in the long layout is once for all the groups. Attaching per\n      group put N listeners on the one shared compressor, so every chunk was counted N\n      times: `--stdout --layout long --gzip` on a 40-rate recording claimed 622,240 of\n      622,240 bytes where 15,556 had been written, failed with a disk-full error over a\n      perfectly good file, and printed Node's MaxListenersExceededWarning to stderr on the\n      way past ten. 0.5.4 fixed the same arithmetic in the uncompressed branch and left\n      this one, because the uncompressed branch is where the count is a sum and this one is\n      where it is a subscription.\n    */\n    if (audit && stream !== target && !shared) {\n      stream.on('data', (chunk: Buffer) => audit.count(chunk.length));\n    }\n    /*\n      One writer, not one per group, when the table is shared. Separate writers over one\n      stream each hold their own buffer and flush on their own schedule, so the rows would\n      reach the file in whatever order the buffers filled — which is not the order they\n      were produced in, and the long layout's whole claim is that its rows are in time\n      order.\n    */\n    const writer = shared?.writer ?? new BufferedLineWriter(stream, flushThreshold);\n    if (plan.layout === 'long' && !shared) shared = { stream, settled, release, target, writer };\n\n    // Only the first group writes the header of a shared table, and the mark before it.\n    if (plan.layout !== 'long' || groupIndex === 0) {\n      if (options.bom === true) writer.push(UTF8_BOM);\n      writer.pushLine(\n        plan.layout === 'long'\n          ? csvRow([TIME_COLUMN, 'channel', 'value'])\n          : csvRow([TIME_COLUMN, ...group.channels.map((c) => c.column)]),\n      );\n    }\n    return {\n      group,\n      writer,\n      formatters: group.channels.map((c) => makeSampleFormatter(c.signal, c.decimals, sampleCaches)),\n      formatTime: makeTimeFormatter(\n        group.samplesPerRecord,\n        group.rate,\n        group.timeDecimals,\n        offsets,\n      ),\n      rows: 0,\n      settled,\n      release,\n    };\n  });\n\n  try {\n    const written = await streamSignalRows(file, plan, open, recordStarts, options);\n\n    /*\n      Checked once everything has been flushed and ended, and not when the reader hung up.\n\n      `--stdout | head -1` closes the pipe on purpose, which is a shell idiom rather than a\n      failure. A pipe is not a regular file, so auditStdout declines it anyway — the second\n      guard is here because the cost of getting this one wrong is reporting a failure for a\n      command that worked.\n    */\n    if (audit) {\n      // Uncompressed, the writer hands its bytes straight to the descriptor; compressed,\n      // they were counted on the compressor's way out.\n      if (options.gzip !== true) {\n        /*\n          Once per writer, not once per group. The long layout gives every group the same\n          writer, so counting per group multiplied its byte total by the number of rates:\n          `--stdout --layout long` on a three-rate recording handed over 32,043 bytes, was\n          credited with 96,129, and failed with a disk-full error for a file that was\n          complete on disk. It only showed with stdout redirected to a regular file, since\n          that is the one case the audit applies to — which is the command the --layout\n          documentation gives.\n        */\n        for (const writer of new Set(open.map((entry) => entry.writer))) {\n          audit.count(writer.bytesOut);\n        }\n      }\n      if (!open.some((entry) => entry.writer.hungUp)) audit.verify();\n    }\n    onHangUp?.(open.some((entry) => entry.writer.hungUp));\n    return written;\n  } catch (cause) {\n    for (const entry of open) entry.writer.destroy();\n\n    /*\n      Reading and writing both fail through here, and both were reported as writing.\n\n      A recording that shrinks mid-conversion — still being written by the acquisition\n      software, say — raises the reader's own error, which names the record and says the\n      file changed size while it was being read. That precise diagnosis was then filed under\n      `Writing to \"<dir>\" failed` and given the hint about freeing disk space, which sends\n      someone to look at the one part of the system that was working.\n\n      The reader's message and its advice are kept; only the note about partial output is\n      added, since that much is true of either failure.\n    */\n    // A ConversionError arrived already saying what went wrong — a callback that threw, say.\n    // Wrapping it again turned \"the onProgress callback threw\" into `Writing to \"out\"\n    // failed: the onProgress callback threw`, under a hint about checking the destination.\n    if (cause instanceof ConversionError) throw cause;\n\n    if (cause instanceof EdfError) {\n      const where = outputDir === null ? 'stdout' : `\"${outputDir}\"`;\n      throw new ConversionError(\n        'INPUT_UNREADABLE',\n        cause.message,\n        `${cause.hint ? `${cause.hint} ` : ''}What was written to ${where} before it failed is ` +\n          `incomplete and should not be used.`,\n      );\n    }\n\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new ConversionError(\n      'WRITE_FAILED',\n      `Writing to ${outputDir === null ? 'stdout' : `\"${outputDir}\"`} failed: ${detail}`,\n      writeHint(cause, outputDir === null),\n    );\n  }\n}\n\n/**\n * One record's samples in the long layout: `time_s,channel,value`, in time order.\n *\n * The groups are merged rather than written one after another. Every sample in a record\n * falls inside that record's span, so taking the earliest next sample across the groups\n * each time leaves the whole file sorted by `time_s` — which is the only thing that makes a\n * mixed-rate long table useful, since sorting 3 million rows afterwards is the reader's\n * problem and a large one.\n *\n * Ties go to the group with the higher rate, which is the order the groups are already in.\n * Within a sample time the channels come out in the order the file declares them.\n */\n/**\n * Whether two sample times are close enough that only rounding could separate them.\n *\n * A relative epsilon, because the gap between doubles grows with magnitude. Well below any\n * real sample interval — the finest a recording can declare is bounded by its record\n * duration and samples-per-record fields — and well above the one-ULP disagreement that two\n * exact divisions of the same instant produce.\n */\nfunction nearlyEqual(a: number, b: number): boolean {\n  return Math.abs(a - b) <= Math.max(Math.abs(a), Math.abs(b)) * 1e-12;\n}\n\n/** The chosen instant as it will be written, for deciding which channels share it. */\nfunction formatAt(\n  open: readonly OpenGroup[],\n  cursors: Int32Array,\n  recordStart: number,\n  earliest: number,\n): string {\n  for (let g = 0; g < open.length; g++) {\n    const entry = open[g];\n    if (!entry) continue;\n    const sample = cursors[g] ?? 0;\n    if (sample >= entry.group.samplesPerRecord) continue;\n    if (recordStart + sample / entry.group.rate === earliest) {\n      return entry.formatTime(recordStart, sample);\n    }\n  }\n  return '';\n}\n\nasync function writeLongRecord(\n  file: EdfFile,\n  open: readonly OpenGroup[],\n  batch: RecordBatch,\n  recordInBatch: number,\n  recordStart: number,\n  range: ConversionPlan['range'],\n): Promise<void> {\n  const writer = open[0]?.writer;\n  if (!writer) return;\n\n  const cursors = new Int32Array(open.length);\n  /* Reused across sample times so a three-million-row conversion allocates one of these. */\n  const due: { entry: OpenGroup; groupIndex: number; sample: number; channel: number }[] = [];\n\n  for (;;) {\n    let earliest = Infinity;\n    for (let g = 0; g < open.length; g++) {\n      const entry = open[g];\n      if (!entry) continue;\n      const sample = cursors[g] ?? 0;\n      if (sample >= entry.group.samplesPerRecord) continue;\n      const time = recordStart + sample / entry.group.rate;\n      if (time < earliest) earliest = time;\n    }\n    if (earliest === Infinity) return;\n\n    /*\n      Everything at this instant, in the order the file declares its channels.\n\n      Groups are ordered by rate, largest first, because that is how the wide layout names\n      its files. Emitting a tie group by group therefore ordered the channels by descending\n      sampling rate — so a recording declaring `slow, medium, fast` wrote `fast, medium,\n      slow`, while the documentation promised file order and channels.csv listed file order.\n      Signal index is the file's own order, and the only one a reader can predict.\n\n      \"At this instant\" is decided on the time as written, not on the double. `s / rate` for\n      two channels at one moment need not give the same double: a 0.3 s record holding 12 and\n      4 samples makes 40 Hz and 13.333… Hz, and 9/40 is 0.22500000000000000555 while 3/13.333…\n      is 0.22499999999999997780. Equality missed that, so those two rows fell out in numeric\n      order — `slow` before `fast`, once, in the middle of a file that was otherwise right.\n\n      Two rows are at one time exactly when they carry the same `time_s`, which is the only\n      definition a reader of the CSV can apply. The numeric pre-filter keeps the common case\n      to one comparison; formatting happens only for candidates already within a hair.\n    */\n    const earliestText = formatAt(open, cursors, recordStart, earliest);\n    due.length = 0;\n    for (let g = 0; g < open.length; g++) {\n      const entry = open[g];\n      if (!entry) continue;\n      const sample = cursors[g] ?? 0;\n      if (sample >= entry.group.samplesPerRecord) continue;\n      const time = recordStart + sample / entry.group.rate;\n      if (time !== earliest) {\n        // Far away in the ordinary case; only a near-tie is worth formatting.\n        if (!nearlyEqual(time, earliest)) continue;\n        if (entry.formatTime(recordStart, sample) !== earliestText) continue;\n      }\n      cursors[g] = sample + 1;\n      // Same window rule as the wide layout, with the same per-rate slack.\n      if (\n        !sampleTimeIsInRange(earliest, range.startSeconds, range.endSeconds, toleranceFor(entry.group.rate))\n      ) {\n        continue;\n      }\n      for (let c = 0; c < entry.group.channels.length; c++) {\n        due.push({ entry, groupIndex: g, sample, channel: c });\n      }\n    }\n    if (due.length === 0) continue;\n    if (due.length > 1) {\n      due.sort(\n        (a, b) =>\n          (a.entry.group.channels[a.channel]?.signal.index ?? 0) -\n          (b.entry.group.channels[b.channel]?.signal.index ?? 0),\n      );\n    }\n\n    for (const item of due) {\n      const channel = item.entry.group.channels[item.channel];\n      const format = item.entry.formatters[item.channel];\n      if (!channel || !format) continue;\n      if (writer.hungUp) return;\n      writer.pushLine(\n        `${item.entry.formatTime(recordStart, item.sample)},${escapeCsvField(channel.column)},` +\n          `${format(file.sampleAt(batch, recordInBatch, channel.signal, item.sample))}`,\n      );\n      item.entry.rows++;\n      // Flushed inside the record for the same reason the wide layout is; see there.\n      if (writer.full) await writer.flush();\n    }\n  }\n}\n\nasync function streamSignalRows(\n  file: EdfFile,\n  plan: ConversionPlan,\n  open: OpenGroup[],\n  recordStarts: Float64Array | null,\n  options: ConvertOptions,\n): Promise<WrittenFile[]> {\n  const { startSeconds, endSeconds, startRecord, endRecord } = plan.range;\n  const { recordDuration } = file.header;\n  let recordsDone = 0;\n\n  /*\n    Every destination has hung up, so nothing formatted from here on could reach anyone.\n    `--stdout | head -1` is the usual way to arrive here: the reader takes one line and\n    closes the pipe while the conversion is still near the start of the recording.\n\n    Stopping also makes the reported row count mean what it says — rows that reached the\n    consumer, rather than rows the loop went on formatting into a discarded buffer.\n  */\n  const allHungUp = (): boolean => open.length > 0 && open.every((entry) => entry.writer.hungUp);\n\n  for await (const batch of file.readRecords({ startRecord, endRecord })) {\n    if (allHungUp()) break;\n    for (let r = 0; r < batch.recordCount; r++) {\n      if (allHungUp()) break;\n      const index = batch.firstRecordIndex + r;\n      const recordStart = recordStarts ? (recordStarts[index] ?? index * recordDuration) : index * recordDuration;\n\n      if (plan.layout === 'long') {\n        await writeLongRecord(file, open, batch, r, recordStart, plan.range);\n        recordsDone++;\n        continue;\n      }\n\n      for (const entry of open) {\n        const { group, writer, formatters, formatTime } = entry;\n        const { channels, rate } = group;\n        // Slack that never reaches the next sample; see toleranceFor.\n        const slack = toleranceFor(rate);\n\n        for (let sample = 0; sample < group.samplesPerRecord; sample++) {\n          const time = recordStart + sample / rate;\n          if (!sampleTimeIsInRange(time, startSeconds, endSeconds, slack)) continue;\n\n          let row = formatTime(recordStart, sample);\n          for (let c = 0; c < channels.length; c++) {\n            const channel = channels[c];\n            const format = formatters[c];\n            if (!channel || !format) continue;\n            row += ',' + format(file.sampleAt(batch, r, channel.signal, sample));\n          }\n          if (writer.hungUp) break;\n          writer.pushLine(row);\n          entry.rows++;\n\n          /*\n            Flushed inside the record, not only at the end of one.\n\n            The buffer was drained once per record, so the rows of a single record piled up\n            with nothing emptying them — memory followed samples-per-record rather than the\n            batch size the writer exists to hold to. One record of 16,000,000 samples died\n            with a heap out of memory under a 256 MB cap, while the same 32 MB of samples\n            split into 16,000 records converted to the same 283 MB CSV without trouble. The\n            format allows either layout and says nothing about which to expect.\n\n            `full` is a synchronous read of the pending size, so the twenty million rows that\n            are not at a boundary cost a comparison rather than a microtask each.\n          */\n          if (writer.full) await writer.flush();\n        }\n        await writer.maybeFlush();\n      }\n\n      recordsDone++;\n    }\n\n    if (options.onProgress) {\n      /*\n        A caller's callback is the caller's, and its failures are not the destination's.\n\n        This ran inside the same try that turns a stream failure into WRITE_FAILED, so a\n        progress callback that threw came back as `Writing to \"out\" failed: caller bug`,\n        advising the reader to check a destination that was working perfectly. It is the\n        same misattribution the write hints had until 0.4.36, one layer up.\n\n        The original is kept as `cause`, so the stack that actually matters survives, and\n        the conversion still stops — the callback threw, and carrying on writing into a\n        directory whose owner has just failed is not an improvement.\n      */\n      try {\n        options.onProgress({\n          recordsDone,\n          recordsTotal: endRecord - startRecord,\n          // Once per writer: the long layout's groups share one, so summing per group\n          // reported a figure larger than the file being written.\n          bytesWritten: [...new Set(open.map((entry) => entry.writer))].reduce(\n            (sum, entry) => sum + entry.charsWritten,\n            0,\n          ),\n        });\n      } catch (cause) {\n        throw new ConversionError(\n          'CALLBACK_FAILED',\n          `The onProgress callback threw: ${cause instanceof Error ? cause.message : String(cause)}`,\n          'This is the caller\\'s callback, not the recording or the destination. Whatever was ' +\n            'written before it threw is incomplete and should not be used.',\n          { cause },\n        );\n      }\n    }\n  }\n\n  const closed = new Set<BufferedLineWriter>();\n  for (const entry of open) {\n    if (closed.has(entry.writer)) continue;\n    closed.add(entry.writer);\n    try {\n      await entry.writer.end();\n      // With --gzip the writer's stream is the compressor, whose end callback fires when the\n      // compressor is done rather than when the file behind it is. Awaiting only that would\n      // report success with the tail of the file still in flight.\n      await entry.settled;\n    } finally {\n      // In a finally for the reason 0.5.45 gives about the writer's own release: a\n      // conversion that fails here still has to leave process.stdout as it found it, and a\n      // failure is exactly when a caller goes on to convert something else.\n      entry.release();\n    }\n  }\n\n  // A shared table is one file, and its row count is every group's rows, not the first's.\n  if (plan.layout === 'long') {\n    const first = open[0];\n    if (!first) return [];\n    return [{ name: first.group.fileName, rows: open.reduce((sum, e) => sum + e.rows, 0) }];\n  }\n  return open.map((entry) => ({ name: entry.group.fileName, rows: entry.rows }));\n}\n\n/**\n * The stream rows are written to, plus a promise for the data reaching its destination.\n *\n * Compression sits between the writer and the file as a transform. Failures below it — a\n * full disk, an unwritable path — surface on the file stream, where nothing is listening,\n * so they are forwarded onto the compressor: that is the stream the writer watches, and\n * routing them there keeps one error path rather than two.\n */\nfunction compressed(\n  target: Writable,\n  gzip: boolean,\n): { stream: Writable; settled: Promise<void>; release: () => void } {\n  if (!gzip) return { stream: target, settled: Promise.resolve(), release: (): void => {} };\n  const compressor = createGzip();\n  /*\n    Removable, because one of the streams this can be handed outlives the conversion.\n\n    0.5.36 fixed exactly this leak for the writer's own listener: a library caller running\n    twelve `toStdout` conversions left twelve 'error' listeners on `process.stdout` and got\n    Node's MaxListenersExceededWarning on the eleventh. That fix is `BufferedLineWriter`'s\n    `#release()`, and it cannot reach this one — under `gzip` the writer's stream is the\n    compressor, and `process.stdout` is only ever the compressor's destination. So the same\n    leak survived on the same stream, behind one extra flag, and the regression test written\n    to catch it does not pass `gzip: true`.\n\n    A file stream is a different matter and needs no release: it is created for this\n    conversion and closed with it. The discipline is the writer's — release only from a\n    stream this tool does not own.\n  */\n  const forward = (error: Error): void => {\n    compressor.destroy(error);\n  };\n  target.on('error', forward);\n  const release = (): void => {\n    if (target === process.stdout || target === process.stderr) target.off('error', forward);\n  };\n\n  /*\n    pipe() ends its destination when the source ends, and stdout must survive the\n    conversion: the writer already refuses to close it, because a closed stdout breaks\n    every later write in the process. Nothing waits on stdout either — it is not this\n    tool's to finish.\n  */\n  const toStdout = target === process.stdout;\n  compressor.pipe(target, { end: !toStdout });\n  if (toStdout) {\n    /*\n      Waited on, even though stdout is not ours to end.\n\n      This returned an already-resolved promise, so `await entry.settled` waited for nothing\n      and the conversion declared itself finished while the compressor still held the tail of\n      the stream. `--stdout --gzip` onto a destination that filled up therefore printed the\n      ENOSPC *and then* \"Wrote 102,400 rows to stdout.\" — and exited 0, over a file 11,270\n      bytes short whose gzip member has no trailer and will not decompress. Through `--out`,\n      on the same volume with the same space, the identical failure is reported and exits 1.\n\n      The byte audit could not see it either: it stats the descriptor as soon as the writers\n      are done, which on this path is before the compressor has pushed its last chunks.\n\n      `finished(compressor)` is the source side, not the destination — it resolves when the\n      compressor has flushed everything into stdout, and it is stdout's own write that fails.\n      That keeps `end: !toStdout` exactly as it was: nothing here closes stdout.\n    */\n    const flushed = finished(compressor).catch((error: unknown) => {\n      /*\n        EPIPE is not a failure here, and turning it into one is the trap this nearly fell\n        into: `--stdout --gzip | head` is an ordinary thing to type, and the documented\n        answer to it is \"Stopped: the reader closed the pipe after 52,507 of 102,400 rows\n        had been written\", exit 0. Waiting on the compressor surfaced the EPIPE that the\n        uncompressed path already routes through the writer's hang-up flag — the writer\n        sees the same error, forwarded, and records it — so the wait has to let that one\n        through and keep everything else.\n      */\n      if ((error as NodeJS.ErrnoException | null)?.code === 'EPIPE') return;\n      throw error;\n    });\n    flushed.catch(() => {});\n    return { stream: compressor, settled: flushed, release };\n  }\n\n  /*\n    A failure under the compressor rejects both this promise and the writer's own end(),\n    and end() is the one awaited first. Without a handler attached here that rejection\n    belonged to nobody, and Node killed the process over it: `--gzip` into an unwritable\n    path printed a raw EISDIR stack trace instead of the ordinary \"Writing to ... failed\"\n    message and exit 1, which is what the same path does uncompressed.\n\n    Attaching the handler is enough to make it handled. Awaiting `settled` downstream still\n    reports the failure in the case where end() happened to succeed.\n  */\n  const settled = finished(target);\n  settled.catch(() => {});\n  return { stream: compressor, settled, release };\n}\n\n/**\n * Write one of the sidecar files, reporting a failure the way the signal writer does.\n *\n * These three used to call `writeFile` bare, so a failure escaped as whatever the\n * filesystem said — `EISDIR: illegal operation on a directory, open '...'` with no hint\n * and, more importantly, no mention that the signal files had already been written. The\n * conversion stopped half-done and the message gave no sign of it.\n */\nasync function writeOutputFile(\n  outputDir: string,\n  name: string,\n  contents: string,\n  gzip = false,\n  bom = false,\n): Promise<void> {\n  // metadata.json never gets one: JSON.parse rejects a leading U+FEFF, so a mark there\n  // would break every reader of the file to help a spreadsheet that will not open it.\n  if (bom) contents = UTF8_BOM + contents;\n  try {\n    // The sidecars are built in memory before being written, so compressing them in memory\n    // costs nothing extra. Only the signal tables are large enough to need a stream.\n    await writeFile(path.join(outputDir, name), gzip ? gzipSync(contents) : contents, gzip ? undefined : 'utf8');\n  } catch (cause) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new ConversionError(\n      'WRITE_FAILED',\n      `Writing \"${name}\" to \"${outputDir}\" failed: ${detail}`,\n      writeHint(cause),\n    );\n  }\n}\n\nasync function writeChannelsCsv(\n  outputDir: string,\n  file: EdfFile,\n  plan: ConversionPlan,\n  gzip: boolean,\n  bom: boolean,\n): Promise<WrittenFile> {\n  const includedColumns = new Set(plan.groups.flatMap((g) => g.channels.map((c) => c.signal.index)));\n  const fileFor = new Map<number, string>();\n  for (const group of plan.groups) {\n    for (const channel of group.channels) fileFor.set(channel.signal.index, group.fileName);\n  }\n\n  const lines = [\n    csvRow([\n      'column',\n      'signal_index',\n      'label',\n      'unit',\n      'sampling_rate_hz',\n      'samples_per_record',\n      'physical_min',\n      'physical_max',\n      'digital_min',\n      'digital_max',\n      'transducer',\n      'prefiltering',\n      'output_file',\n      'converted',\n    ]),\n  ];\n\n  for (const signal of file.header.signals) {\n    if (signal.isAnnotations) continue;\n    const column = plan.columnNames.get(signal.index) ?? `signal_${signal.index}`;\n    lines.push(\n      csvRow([\n        column,\n        String(signal.index),\n        signal.label,\n        signal.physicalDimension,\n        String(signal.samplingRate),\n        String(signal.samplesPerRecord),\n        String(signal.physicalMin),\n        String(signal.physicalMax),\n        String(signal.digitalMin),\n        String(signal.digitalMax),\n        signal.transducer,\n        signal.prefiltering,\n        fileFor.get(signal.index) ?? '',\n        includedColumns.has(signal.index) ? 'yes' : 'no',\n      ]),\n    );\n  }\n\n  const name = gzip ? 'channels.csv.gz' : 'channels.csv';\n  await writeOutputFile(outputDir, name, lines.join('\\n') + '\\n', gzip, bom);\n  return { name, rows: lines.length - 1 };\n}\n\n/*\n  The bounds an annotation is filtered against: what the caller actually asked for, not the\n  window that survived being clamped to the recording.\n\n  Filtering by the resolved window meant an unbounded request still lost events. `--end 999h`\n  on a three-second file clamps to 3, and `--start 0` gets its end from the recording, so\n  both filtered to [0, 3) and dropped the markers at 3.0 and 3.5 that a bare invocation\n  keeps — asking for more of a recording returned less of it.\n\n  An end the caller did not give is unbounded, not \"the end of the data\": EDF+ lets an\n  annotation sit past the last sample, which is exactly where an end-of-recording marker is.\n\n  `--duration` is measured from wherever the conversion actually starts. Anchoring it at 0\n  instead read the same absent `--start` two ways in two adjacent lines, and on a recording\n  that does not begin at zero the two windows did not even overlap: an EDF+D file whose first\n  record sits at 30 s converted its samples from [30, 35) while filtering annotations against\n  (-inf, 5), so every event inside the converted window was dropped and `annotations.csv` came\n  back empty. `resolveRange` has always defaulted the same missing start to the earliest\n  record, which is where this now takes it from.\n*/\n/**\n * What the durations in the events that will actually be written look like.\n *\n * These two warnings were raised from the file-wide counts the decoder accumulates, while\n * `annotations.csv` is filtered to the requested window. A conversion of one second of a\n * recording therefore warned that \"1 annotation states a duration that is not a number, so\n * its duration_s cell is empty\" about an event two seconds outside it — naming a cell that is\n * not in the output — and `--strict` failed the run for it. There is no such value, no such\n * cell, and no such row.\n *\n * Taken from the events themselves, after the same filter the writer applies, so the count\n * and the sentence describe the same rows. An unreadable duration is carried on the event\n * because `duration: null` cannot say whether the file gave one; a negative duration needs no\n * flag, since the value is right there.\n */\nexport function durationDiagnostics(\n  annotations: readonly Annotation[],\n  window: { from: number; to: number },\n): Diagnostic[] {\n  const written = annotations.filter((a) => a.onset >= window.from && a.onset < window.to);\n  const diagnostics: Diagnostic[] = [];\n\n  const negative = written.filter((a) => a.duration !== null && a.duration < 0).length;\n  if (negative > 0) {\n    const one = negative === 1;\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${negative} annotation${one ? '' : 's'} state${one ? 's' : ''} a duration below zero, ` +\n        `which is not a length of time.`,\n      hint:\n        'The value is written to annotations.csv as the file gave it. Adding it to onset_s ' +\n        'ends the event before it starts, so check these rows before using the durations.',\n    });\n  }\n\n  const unreadable = written.filter((a) => a.durationUnreadable === true).length;\n  if (unreadable > 0) {\n    const one = unreadable === 1;\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${unreadable} annotation${one ? '' : 's'} state${one ? 's' : ''} a duration that is ` +\n        `not a number, so ${one ? 'its' : 'their'} duration_s cell is empty.`,\n      hint:\n        'The onset and the description were read normally. An empty duration_s otherwise ' +\n        'means the file stated no duration, so these rows cannot be told apart from those.',\n    });\n  }\n\n  return diagnostics;\n}\n\n/**\n * The window annotations are filtered by — the bounds as asked for, not as snapped to records.\n *\n * Exported so `--info` can count the events a conversion would write using the same predicate\n * that writes them, rather than a second copy of it.\n */\nexport function requestedAnnotationWindow(\n  options: ConvertOptions,\n  recordingStart: number,\n): { from: number; to: number } {\n  const from = options.start ?? -Infinity;\n  const to =\n    options.end !== undefined\n      ? options.end\n      : options.duration !== undefined\n        ? (options.start ?? recordingStart) + options.duration\n        : Infinity;\n  return { from, to };\n}\n\nasync function writeAnnotationsCsv(\n  outputDir: string,\n  annotations: readonly Annotation[],\n  window: { from: number; to: number },\n  gzip: boolean,\n  bom: boolean,\n): Promise<WrittenFile> {\n  const inWindow = annotations\n    .filter((a) => a.onset >= window.from && a.onset < window.to)\n    .sort((a, b) => a.onset - b.onset || a.recordIndex - b.recordIndex);\n\n  const lines = [csvRow(['onset_s', 'duration_s', 'description', 'record_index'])];\n  for (const annotation of inWindow) {\n    lines.push(\n      csvRow([\n        plain(annotation.onset),\n        annotation.duration === null ? '' : plain(annotation.duration),\n        annotation.text,\n        String(annotation.recordIndex),\n      ]),\n    );\n  }\n\n  const name = gzip ? 'annotations.csv.gz' : 'annotations.csv';\n  await writeOutputFile(outputDir, name, lines.join('\\n') + '\\n', gzip, bom);\n  return { name, rows: inWindow.length };\n}\n\n/**\n * What to try next, chosen from what actually went wrong.\n *\n * Every write failure carried the same advice — \"Free up space or choose another destination\n * with --out\" — which fits exactly one errno. A directory sitting where signals.csv belongs\n * came back telling the reader to free up disk space, and so did a read-only volume, a\n * permission denial and a path too long for the filesystem. Wrong advice is worse than none:\n * it sends someone to check `df` on a disk that is fine, and the thing that is actually\n * wrong stays unexamined.\n *\n * The errno is the one piece of the failure that names the cause, so it is what picks the\n * sentence. Anything unrecognised keeps the general form rather than guessing.\n */\nfunction writeHint(cause: unknown, toStdout = false): string {\n  /*\n    The stdout path writes no files, and --out is the flag its user chose not to pass.\n\n    Both halves of this sentence were wrong there: \"the files written so far\" named files\n    that do not exist, and \"choose another destination with --out\" is advice for a different\n    command — the destination is whatever the shell redirected the stream to. Same class as\n    the disk-space hint this function replaced, one flag over.\n  */\n  const preamble = toStdout\n    ? 'What reached stdout before it failed is incomplete and should not be used. '\n    : 'The files written so far are incomplete and should not be used. ';\n  const elsewhere = toStdout ? 'redirect it somewhere else' : 'choose another with --out';\n  const code = (cause as NodeJS.ErrnoException | null)?.code;\n  switch (code) {\n    case 'ENOSPC':\n      return `${preamble}The destination is out of space; free some up or ${elsewhere}.`;\n    case 'EDQUOT':\n      return `${preamble}You are over your disk quota on this filesystem; ${elsewhere}.`;\n    case 'EACCES':\n    case 'EPERM':\n      return `${preamble}You do not have permission to write there; ${elsewhere}.`;\n    case 'EROFS':\n      return `${preamble}That filesystem is mounted read-only; ${elsewhere}.`;\n    case 'EISDIR':\n      return `${preamble}A directory is sitting where that file belongs; remove or rename it, or ${elsewhere}.`;\n    case 'ENOENT':\n      return `${preamble}Part of that path no longer exists; make sure nothing is removing it while the conversion runs.`;\n    case 'ENAMETOOLONG':\n      return `${preamble}That path is longer than the filesystem allows; ${toStdout ? 'redirect it somewhere shorter' : 'choose a shorter destination with --out'}.`;\n    case 'EMFILE':\n    case 'ENFILE':\n      return `${preamble}Too many files are open; a recording with many sampling rates opens one output file per rate, so --channels narrows it.`;\n    case 'EPIPE':\n      return `${preamble}Whatever was reading the output closed it before the conversion finished.`;\n    default:\n      return `${preamble}Check the destination and run the conversion again.`;\n  }\n}\n\n/**\n * Confirms that everything handed to a file-backed stdout actually arrived.\n *\n * `edf2csv rec.edf --stdout > out.csv` onto a volume that the output very nearly fills lost\n * the tail in silence: 94,977 of 102,400 rows on disk, the file ending mid-row, stderr\n * announcing \"Wrote 102,400 rows to stdout.\" and the process exiting 0. The same recording\n * onto the same volume through `--out` fails correctly, which is what gives it away.\n *\n * POSIX `write` returns a short count rather than an error when the disk fills partway\n * through a single call, and only the NEXT write raises ENOSPC. `--out` always has a next\n * write — channels.csv and metadata.json come after — so it always finds out. `--stdout`\n * has nothing after it, and when fd 1 is a regular file Node's stdout is a SyncWriteStream\n * whose `_write` discards the byte count `writeSync` returns, so nothing is raised at all.\n * No error means no `#failure`, so checking that alone would not have caught this.\n *\n * What can be checked is the descriptor: how much it grew against how much it was given.\n * Only for a regular file — a pipe, a terminal or a socket has no size to compare, and on\n * those a short write cannot go unreported this way. Appending (`>>`) is fine, since the\n * starting size is taken before anything is written.\n */\n/**\n * Exported so `--info` can use the same audit a `--stdout` conversion does.\n *\n * `--info` wrote its description with `process.stdout.write` and looked at nothing: redirected\n * into a full filesystem it produced a zero-byte file and exited 0, so `edf2csv rec.edf --info\n * > desc.txt` reported success over nothing at all. A 900-channel recording's description is\n * 58 KB, which is not a size a destination is guaranteed to have.\n */\nexport function auditStdout(): { count: (bytes: number) => void; verify: () => void } | null {\n  let startSize: number;\n  try {\n    const info = fstatSync(1);\n    if (!info.isFile()) return null;\n    startSize = info.size;\n  } catch {\n    // No usable descriptor to audit; the conversion is not the place to complain about it.\n    return null;\n  }\n\n  let expected = 0;\n  return {\n    count: (bytes: number): void => {\n      expected += bytes;\n    },\n    verify: (): void => {\n      let landed: number;\n      try {\n        landed = fstatSync(1).size - startSize;\n      } catch {\n        return;\n      }\n      if (landed >= expected) return;\n\n      /*\n        This audit exists for the failure nothing else reports: a write that is accepted, and\n        silently truncated. When the stream itself raised an error there is nothing left for\n        it to add, and what it added was a second `error:` line denying the first —\n\n          error: Writing to stdout failed: ENOSPC: no space left on device, write\n          error: Writing to stdout failed: 58900 of 58900 bytes did not reach the destination,\n                 which stopped accepting them part way through.\n                 ... nothing after it raised an error because there was nothing after it.\n\n        one failure, reported twice, the second of the two wrong about it.\n      */\n      if (process.stdout.errored) return;\n\n      /*\n        Nothing landing at all is not a short write, and was described as one.\n\n        `--info > desc.txt` onto a full filesystem left a zero-byte file, and this said the\n        destination \"stopped accepting them part way through\" and that \"what is there ends\n        mid-row\" — of a file with nothing in it and no rows in it.\n      */\n      if (landed === 0) {\n        throw new ConversionError(\n          'WRITE_FAILED',\n          `Writing to stdout failed: none of the ${expected} bytes reached the destination.`,\n          'The destination is almost certainly out of space. Nothing was written, so there ' +\n            'is nothing there to discard.',\n        );\n      }\n      throw new ConversionError(\n        'WRITE_FAILED',\n        `Writing to stdout failed: ${expected - landed} of ${expected} bytes did not reach ` +\n          `the destination, which stopped accepting them part way through.`,\n        'What is there ends mid-row and should not be used. The destination is almost ' +\n          'certainly out of space — a short write is how a filesystem reports filling up ' +\n          'mid-write, and nothing after it raised an error because there was nothing after it.',\n      );\n    },\n  };\n}\n\n/**\n * Why `--stdout` cannot take this recording, or null when it can.\n *\n * Lifted out of the conversion so `--info` can ask the same question. It was not asking:\n * `--info --stdout` on a three-rate recording predicted \"Would write 1,155 rows, roughly\n * 22.2 KB\" and said the channels \"are written to one file per rate\" — for a command that\n * refuses to run, writes nothing, and names no files. `--info` exists to say what a\n * conversion will do, and this is one of the things it does.\n *\n * Reported by `--info` as a warning rather than a refusal, for the reason 0.5.51 gives about\n * the destination guards: `--info` writes nothing, so a rule about what the output would be\n * has no business stopping it from describing the recording — and being told the command\n * will not work is exactly what you asked.\n */\nexport function stdoutRefusal(file: EdfFile, plan: ConversionPlan): ConversionError | null {\n  if (!plan.writeSignals) {\n    return new ConversionError(\n      'UNSUPPORTED_REQUEST',\n      '--stdout has no signal data to write because --annotations-only was given.',\n      'Drop one of the two flags.',\n    );\n  }\n\n    /*\n      No table at all is its own answer, and neither layout gave it.\n\n      A recording with no signal channels — one holding only EDF+ annotations — produced\n      zero rate groups. The wide layout then said \"--stdout needs exactly one table, but\n      this recording produces 0, one for each sampling rate its channels use ()\", with an\n      empty parenthetical, advice to narrow to one of no rates, and advice to use\n      `--layout long` — which wrote zero bytes to stdout, not even a header row, and exited\n      0 while warning that \"the signal files hold their headers and no data\". There were no\n      files and there was no header. The one path that was right about this is\n      `--annotations-only`, which refuses outright, and this is the same situation reached\n      by a different route.\n    */\n    if (plan.groups.length === 0) {\n      return new ConversionError(\n        'UNSUPPORTED_REQUEST',\n        file.dataSignals.length === 0\n          ? '--stdout has no signal data to write: this recording has no signal channels, ' +\n            'only EDF+ annotations.'\n          : '--stdout has no signal data to write: nothing was selected that carries samples.',\n        file.dataSignals.length === 0\n          ? 'Convert to a directory to get its annotations.csv, or drop --stdout.'\n          : 'Check --channels and the requested window, or convert to a directory instead.',\n      );\n    }\n\n    // The long layout is one table whatever the rates are, so it has nothing to refuse.\n    if (plan.layout !== 'long' && plan.groups.length !== 1) {\n      return new ConversionError(\n        'UNSUPPORTED_REQUEST',\n        // Naming the rates is the point: the hint says to narrow the selection, and this\n        // is what there is to narrow it to. The parenthetical used to repeat the count\n        // that had just been given — \"produces 3 (its channels use 3 different sampling\n        // rates)\" — which told nobody anything they could act on.\n        `--stdout needs exactly one table, but this recording produces ${plan.groups.length}, ` +\n          `one for each sampling rate its channels use ` +\n          `(${listed(formatRates(plan.groups.map((g) => g.rate)).map((r) => `${r} Hz`))}).`,\n        'Narrow it to one rate with --channels, write --layout long to get them all in ' +\n          'one table, or convert to a directory instead.',\n      );\n    }\n  return null;\n}\n\n\n\n/**\n * Asked for signal data and given none to put in a file.\n *\n * Every channel selected carries zero samples per record, so there is no table to make —\n * `edf2csv rec.edf --channels unused` writes channels.csv and metadata.json and no signals.csv\n * at all. The NO_SAMPLES warning explains the channel; nothing explained the missing file, and\n * the documentation says signals.csv is written unless --annotations-only was passed. Someone\n * looking for it should be told where it went.\n *\n * There are two ways to arrive with no groups, and one wording is only true of one of them. A\n * recording that holds nothing but EDF+ annotations has no channel that could have been\n * selected, its channels.csv is a header row and nothing else, and no channel of it carries\n * samples — so \"every channel selected\", \"channels.csv still describes them\" and \"which\n * channels do carry samples\" were three false statements in one warning, printed under a\n * warning that had just said the file has no signal channels.\n *\n * Exported, and worded in the present tense, so `--info` can raise the same one. It was built\n * inline here, which meant the one mode whose purpose is to say what a conversion will do said\n * nothing about the file that conversion would not write: `--info --strict` on a recording of\n * nothing but annotations reported one warning where converting it reported two, and\n * `--info --json` carried the shorter list to whatever reads it. Everything the answer depends\n * on is in the file and the plan, both of which `--info` already has.\n */\nexport function noSignalFile(file: EdfFile, plan: ConversionPlan): Diagnostic | null {\n  if (!plan.writeSignals || plan.groups.length > 0) return null;\n  const noChannelsAtAll = file.dataSignals.length === 0;\n  return {\n    code: 'NO_SAMPLES',\n    severity: 'warning',\n    message: noChannelsAtAll\n      ? 'No signal file is written: there is no signal data in this recording to put in one.'\n      : 'No signal file is written: every channel selected carries zero samples per data ' +\n        'record, so there is nothing to put in one.',\n    hint: noChannelsAtAll\n      ? 'annotations.csv holds whatever events it carries. channels.csv lists signal ' +\n        'channels, so it has none to list.'\n      : 'channels.csv still describes them. Run with --info to see which channels do carry ' +\n        'samples.',\n  };\n}\n\n/**\n * `--annotations-only` on a recording that has no annotations.\n *\n * Exported and present-tense for the same reason `noSignalFile` above is. `--info` prints an\n * accurate line about it in the report body — \"and no annotations.csv either, since this\n * recording has no annotation channel\" — and raised nothing, so the one mode whose purpose is\n * to say what a conversion will do carried a shorter warning list than the conversion did:\n * `--info --json --annotations-only` on a plain EDF file listed no warning where converting\n * lists one, and `--info --strict`, which cli-reference.md recommends for screening a folder\n * before converting it, exited 0 where the conversion exits 1. Same defect as the one 0.7.84\n * closed for `NO_SAMPLES`, one flag over; both halves of the answer are in the file and the\n * options, which `--info` already has.\n */\nexport function noAnnotations(file: EdfFile, options: ConvertOptions): Diagnostic | null {\n  if (options.annotationsOnly !== true || file.annotationSignals.length > 0) return null;\n  return {\n    code: 'NO_ANNOTATIONS',\n    severity: 'warning',\n    message:\n      '--annotations-only was requested but this recording has no annotation channel, ' +\n      'so there are no events to export.',\n    hint: 'Plain EDF files carry no annotations. Convert without --annotations-only to get the signals.',\n  };\n}\n\n/** Raised when the input moved while it was being read. See where it is pushed. */\nfunction inputChanged(hadChecksum: boolean): Diagnostic {\n  return {\n    code: 'INPUT_CHANGED',\n    severity: 'warning',\n    message:\n      'The input changed while it was being converted, so this output covers the file as ' +\n      'it was when the conversion started, not as it is now.',\n    hint: hadChecksum\n      ? 'No checksum was recorded: the bytes that were converted are no longer there to ' +\n        'hash. Convert again once the recording is finished.'\n      : 'Convert again once the recording is finished to pick up the rest.',\n  };\n}\n\nasync function writeMetadata(\n  outputDir: string,\n  inputPath: string,\n  file: EdfFile,\n  plan: ConversionPlan,\n  written: readonly WrittenFile[],\n  annotationCount: number,\n  /** Hash of the bytes that were converted, or null when it could not be vouched for. */\n  checksum: string | null,\n  /** Whether the record start times could be read; see withTimingPromiseKept. */\n  timedFromRecords: boolean,\n): Promise<void> {\n  const { header } = file;\n\n  /*\n    The file as it was when it was opened, not as it is now.\n\n    Both of these used to come from re-opening the path once the CSVs were written, which\n    describes whatever answers to that name by then rather than what was converted. A\n    recording still being written grew from 2,000 records to 3,000 mid-conversion and\n    metadata.json recorded `data_records: 2000` — correct, the CSV holds 2,000 — beside the\n    byte count and SHA-256 of the 3,000-record file. The two halves of one provenance record\n    described two different files, and the checksum covered bytes nobody had converted.\n    Replacing the file at that path did the same thing more thoroughly.\n\n    `file.fileSize` is the number every record count and window in this output was derived\n    from, and the hash is taken over exactly those bytes through the descriptor already open\n    on them, so the record describes one file throughout.\n  */\n  const metadata = {\n    tool: { name: 'edf2csv', version: TOOL_VERSION },\n    source: {\n      path: path.resolve(inputPath),\n      bytes: file.fileSize,\n      modified: new Date(file.modifiedAtOpenMs).toISOString(),\n      sha256: checksum,\n    },\n    recording: {\n      format: describeFormat(header),\n      version: header.version,\n      patient_id: header.patientId,\n      recording_id: header.recordingId,\n      // Zone-less on purpose: EDF records local wall-clock digits and no timezone.\n      start_datetime_local: formatWallClock(header.startDateTime),\n      start_date_raw: header.startDateRaw,\n      start_time_raw: header.startTimeRaw,\n      data_records: file.recordCount,\n      data_records_declared: header.declaredRecordCount,\n      record_duration_seconds: header.recordDuration,\n      duration_seconds: file.durationSeconds,\n      signal_count: header.signalCount,\n      annotation_channels: file.annotationSignals.length,\n    },\n    conversion: {\n      converted_at: new Date().toISOString(),\n      start_seconds: plan.range.startSeconds,\n      end_seconds: plan.range.endSeconds,\n      whole_recording: plan.range.isWholeRecording,\n      records_converted: [plan.range.startRecord, plan.range.endRecord],\n      annotations_written: annotationCount,\n      /*\n        Which shape the signal table is in, which nothing recorded.\n\n        A wide `signals.csv` and a long one are different files with different columns, and\n        metadata.json described them identically — so a pipeline handed an output directory\n        could not tell from the archive which it had. It matters most for `rate_groups` right\n        below: in the wide layout those entries are one per file and their `channels` are that\n        file's columns, and in the long layout every entry names the one shared table and its\n        `channels` are values in that table's `channel` column. Same array, two readings, and\n        no way to know which applied.\n      */\n      layout: plan.layout,\n      files: written.map((f) => ({ name: f.name, rows: f.rows })),\n      rate_groups: plan.groups.map((g) => ({\n        file: g.fileName,\n        sampling_rate_hz: g.rate,\n        channels: g.channels.map((c) => c.column),\n        decimals: g.channels.map((c) => c.decimals),\n      })),\n    },\n    notes: [\n      ...withTimingPromiseKept(withoutFileRateWarning(file.diagnostics), timedFromRecords),\n      ...plan.diagnostics,\n    ].map((d) => ({\n      code: d.code,\n      severity: d.severity,\n      message: d.message,\n    })),\n  };\n\n  await writeOutputFile(outputDir, 'metadata.json', JSON.stringify(metadata, null, 2) + '\\n');\n}\n\n\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/convert/run.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Executing a conversion.\n *\n * Everything is written in a single pass over the data records. All rate groups are\n * open at once and fed from the same batch of bytes, so a file is read once no\n * matter how many output tables it produces, and memory stays flat.\n */\n\nimport { createWriteStream, fstatSync } from 'node:fs';\nimport { mkdir, readdir, stat, writeFile } from 'node:fs/promises';\nimport { finished } from 'node:stream/promises';\nimport type { Writable } from 'node:stream';\nimport { createGzip, gzipSync } from 'node:zlib';\nimport path from 'node:path';\n\nimport type { RecordBatch } from '../edf/reader.js';\nimport { EdfFile } from '../edf/reader.js';\nimport { describeFormat, formatRates, formatWallClock } from '../edf/header.js';\nimport type { Diagnostic } from '../edf/errors.js';\nimport { EdfError } from '../edf/errors.js';\nimport type { Annotation } from '../edf/annotations.js';\nimport {\n  BufferedLineWriter,\n  DEFAULT_FLUSH_THRESHOLD,\n  UTF8_BOM,\n  csvRow,\n  escapeCsvField,\n} from '../format/csv.js';\nimport { listed } from '../format/list.js';\nimport {\n  makeSampleFormatter,\n  makeTimeFormatter,\n  newOffsetBudget,\n  newSampleCacheBudget,\n  plain,\n} from '../format/number.js';\nimport type { SampleFormatter } from '../format/number.js';\nimport { TIME_COLUMN } from './channels.js';\nimport { assertInputPath } from './options.js';\nimport { buildPlan, withoutFileRateWarning } from './plan.js';\nimport type { ConversionPlan, PlanOptions, RateGroup } from './plan.js';\nimport { deriveRecordStarts, withTimingPromiseKept } from './timing.js';\nimport { sampleTimeIsInRange, toleranceFor } from './time-range.js';\nimport { VERSION as TOOL_VERSION } from '../version.js';\n\nexport { TOOL_VERSION };\n\nexport type ConversionErrorCode =\n  | 'OUTPUT_EXISTS'\n  | 'OUTPUT_UNWRITABLE'\n  | 'INPUT_OUTPUT_COLLISION'\n  | 'INPUT_UNREADABLE'\n  | 'UNSUPPORTED_REQUEST'\n  | 'CALLBACK_FAILED'\n  | 'WRITE_FAILED';\n\n/**\n * Codes that mean the command cannot be carried out as written, rather than that something\n * about the file or the destination went wrong.\n *\n * The distinction is the one the exit codes draw: 1 is \"the file or the destination is the\n * problem\", 2 is \"the command line is the problem\". A caller with a `--stdout` conflict is\n * being told to change the flags — the hints say exactly that — so filing it under 1 sent\n * scripts looking at the disk. Exit 2 already covers checks that need the header first,\n * such as a `--channels` term matching nothing.\n */\nexport const USAGE_ERROR_CODES: ReadonlySet<ConversionErrorCode> = new Set(['UNSUPPORTED_REQUEST']);\n\nexport class ConversionError extends Error {\n  readonly code: ConversionErrorCode;\n  readonly hint: string | undefined;\n  constructor(code: ConversionErrorCode, message: string, hint?: string, options?: ErrorOptions) {\n    super(message, options);\n    this.name = 'ConversionError';\n    this.code = code;\n    this.hint = hint;\n  }\n}\n\nexport interface ConvertOptions extends PlanOptions {\n  /**\n   * Destination directory. Defaults to `defaultOutputDir(inputPath)`: the input's name with\n   * its extension replaced by `_csv`, beside the input — `sleep-study.edf` gives\n   * `sleep-study_csv`, not `sleep-study`.\n   */\n  outputDir?: string | undefined;\n  /** Overwrite an existing output directory. */\n  force?: boolean | undefined;\n  /** Record a SHA-256 of the input in metadata.json. Costs one extra read of the file. */\n  checksum?: boolean | undefined;\n  /**\n   * Write the signal CSV to stdout instead of to a directory.\n   *\n   * Only valid when the conversion produces exactly one signal file. In the default wide\n   * layout a mixed-rate recording becomes several tables, and merging them into one stream\n   * would mean inventing the samples this tool exists not to invent; `layout: 'long'` gives\n   * one table for any recording, so it lifts the restriction. No sidecar files are written.\n   */\n  toStdout?: boolean | undefined;\n  onProgress?: ((progress: ConversionProgress) => void) | undefined;\n}\n\nexport interface ConversionProgress {\n  recordsDone: number;\n  recordsTotal: number;\n  bytesWritten: number;\n}\n\nexport interface WrittenFile {\n  name: string;\n  rows: number;\n}\n\nexport interface ConvertResult {\n  outputDir: string;\n  files: WrittenFile[];\n  /**\n   * True when a `--stdout` reader closed the pipe before the conversion finished.\n   *\n   * `edf2csv rec.edf --stdout | head -1` is an ordinary thing to type and not a failure, but\n   * it is also not a conversion: the row count is rows formatted before the close was\n   * noticed, which is neither the recording's total nor what the reader received.\n   */\n  readerHungUp: boolean;\n  annotationCount: number;\n  diagnostics: Diagnostic[];\n  plan: ConversionPlan;\n  file: EdfFile;\n  elapsedMs: number;\n}\n\ninterface OpenGroup {\n  group: RateGroup;\n  writer: BufferedLineWriter;\n  formatters: SampleFormatter[];\n  formatTime: (recordStart: number, sample: number) => string;\n  rows: number;\n  /** Resolves once a compressed stream's bytes have reached the file behind it. */\n  settled: Promise<void>;\n  /** Detaches the compressor's error forwarding from a stream this tool does not own. */\n  release: () => void;\n}\n\nexport async function convert(inputPath: string, options: ConvertOptions = {}): Promise<ConvertResult> {\n  assertInputPath(inputPath);\n  const startedAt = Date.now();\n  const file = await EdfFile.open(inputPath);\n\n  try {\n    /*\n      Hashed before a record is read, and only published if the file held still.\n\n      A checksum taken afterwards cannot be trusted whichever descriptor it goes through. A\n      file overwritten in place keeps its inode, so the open handle sees the new bytes too,\n      and the old ones are simply gone — there is nowhere left to read what was converted.\n      Taking it first at least means the hash describes the file the header was read from.\n\n      What makes it a guarantee rather than a hope is the check at the end: if size or\n      modification time moved at any point, the hash is dropped and the run says why. So\n      `sha256` present means the file demonstrably did not change while it was read, and a\n      recording still being written gets a null and a warning instead of a plausible hash of\n      the wrong bytes. (A change reverted within the same modification timestamp would slip\n      through; nothing short of copying the input first can close that.)\n    */\n    const checksumAtOpen = options.checksum === true ? await file.sha256() : null;\n\n    // One pass over the annotation channel supplies everything annotation-related:\n    // where each record sits in time, and the full event list. It reads the whole\n    // file even when a window was requested, because an annotation inside the window\n    // may be stored in a record outside it.\n    const annotationData =\n      file.annotationSignals.length > 0\n        ? await file.readAnnotations()\n        : { annotations: [] as Annotation[], recordStarts: [] as (number | null)[], malformed: 0 };\n\n    const timing = deriveRecordStarts(file, annotationData);\n\n    const plan = buildPlan(\n      {\n        signals: file.header.signals,\n        recordDuration: file.header.recordDuration,\n        recordCount: file.recordCount,\n        hasAnnotationChannel: file.annotationSignals.length > 0,\n        recordStarts: timing.starts,\n      },\n      options,\n    );\n    plan.diagnostics.push(...timing.diagnostics);\n\n    if (options.toStdout === true) {\n      const refusal = stdoutRefusal(file, plan);\n      if (refusal) throw refusal;\n      let readerHungUp = false;\n      const written = await writeSignalFiles(file, plan, null, timing.starts, options, (hungUp) => {\n        readerHungUp = hungUp;\n      });\n      if (await file.changedSinceOpen()) plan.diagnostics.push(inputChanged(false));\n      return {\n        outputDir: '-',\n        files: written,\n        readerHungUp,\n        annotationCount: 0,\n        diagnostics: [...withTimingPromiseKept(withoutFileRateWarning(file.diagnostics), timing.starts !== null), ...plan.diagnostics],\n        plan,\n        file,\n        elapsedMs: Date.now() - startedAt,\n      };\n    }\n\n    /*\n      A destination whose last component is `.` or `..` does not name a directory of its own.\n\n      `prepareOutputDir` claims the final component with a single non-recursive mkdir, having\n      created its parents recursively — which is what makes two conversions racing for one\n      directory safe. `path.dirname(\"out/.\")` is `\"out\"`, so for these the parent step creates\n      the destination itself and the claim then asks the filesystem to make `.` inside it,\n      which always exists. The result was a refusal naming a directory this same run had just\n      made, one line after making it:\n\n          edf2csv rec.edf --out ./fresh/.\n          error: \"./fresh/.\" already exists.\n                 Pass --force to overwrite it, or --out to choose a different directory.\n\n      Exit 1, nothing converted, and an empty `fresh/` left on disk. `--force` does not help:\n      the claim fails the same way whatever it is told, so the path was unusable rather than\n      occupied.\n\n      Normalised only in that case, so `--out ./converted` keeps the spelling it was given —\n      that one is already how the directory is found on disk, which is what `output_dir`\n      promises, and rewriting it to `converted` would churn every example for no gain.\n    */\n    const asked = options.outputDir ?? defaultOutputDir(inputPath);\n    const outputDir = /(?:^|[\\\\/])\\.\\.?$/u.test(asked) ? path.normalize(asked) : asked;\n    await assertInputDoesNotOverlapOutputs(inputPath, outputDir, file, plan, options);\n    await prepareOutputDir(outputDir, options.force === true);\n\n    const written: WrittenFile[] = [];\n\n    if (plan.writeSignals && plan.groups.length > 0) {\n      const signals = await writeSignalFiles(file, plan, outputDir, timing.starts, options);\n      written.push(...signals);\n    } else {\n      const missing = noSignalFile(file, plan);\n      if (missing) plan.diagnostics.push(missing);\n    }\n\n    const noEvents = noAnnotations(file, options);\n    if (noEvents) plan.diagnostics.push(noEvents);\n\n    let annotationsWritten = 0;\n    if (file.annotationSignals.length > 0) {\n      const window = requestedAnnotationWindow(options, plan.range.recordingStartSeconds);\n      // Reported against the rows that will be written, not against the file; see\n      // durationDiagnostics.\n      plan.diagnostics.push(...durationDiagnostics(annotationData.annotations, window));\n      const result = await writeAnnotationsCsv(\n        outputDir,\n        annotationData.annotations,\n        window,\n        options.gzip === true,\n        options.bom === true,\n      );\n      written.push(result);\n      annotationsWritten = result.rows;\n    }\n\n    written.push(\n      await writeChannelsCsv(outputDir, file, plan, options.gzip === true, options.bom === true),\n    );\n\n    /*\n      The file moved under the conversion. Said out loud, because nothing else shows it.\n\n      The CSVs are still correct for the records that were read, and metadata.json still\n      describes the file as it was opened — so the record is consistent with the output\n      whatever happens here. What stops being true is that the checksum describes the bytes\n      that were converted, since an in-place overwrite leaves nowhere to read them from. It\n      is dropped rather than guessed at.\n    */\n    const changed = await file.changedSinceOpen();\n    if (changed) plan.diagnostics.push(inputChanged(options.checksum === true));\n\n    await writeMetadata(\n      outputDir,\n      inputPath,\n      file,\n      plan,\n      written,\n      annotationsWritten,\n      changed ? null : checksumAtOpen,\n      timing.starts !== null,\n    );\n\n    const stale = await findStaleOutput(outputDir, written);\n\n    return {\n      outputDir,\n      files: written,\n      readerHungUp: false,\n      annotationCount: annotationsWritten,\n      diagnostics: [...withTimingPromiseKept(withoutFileRateWarning(file.diagnostics), timing.starts !== null), ...plan.diagnostics, ...stale],\n      plan,\n      file,\n      elapsedMs: Date.now() - startedAt,\n    };\n  } finally {\n    await file.close();\n  }\n}\n\n/*\n  Files this tool produces, used to spot leftovers from an earlier conversion.\n\n  The rate part has to allow every shape a filename can now take, not just the plain ones:\n\n    signals_256hz.csv         an integer rate\n    signals_12_5hz.csv        a fractional rate, decimal point written as an underscore\n    signals_1_000e-7hz.csv    a rate small enough to need exponent form  (0.2.2)\n    signals_256hz.csv.gz      any of the above, compressed                (0.3.0)\n    signals_0hz_2.csv         a second group whose rate slug collided    (0.2.1)\n\n  The previous `[\\w.]+hz` matched neither of the last two — `-` and `+` are not word\n  characters, and the collision suffix falls after the `hz`. Both were introduced by\n  recent changes and both silently stopped being recognised as this tool's own output, so\n  leftovers of exactly those kinds went unreported: the one situation the warning exists\n  for. Requiring a digit after the underscore keeps a user's own `signals_notes.csv` out.\n*/\nconst OUTPUT_PATTERN =\n  /^(signals(_\\d[\\w.+-]*hz(_\\d+)?)?\\.csv(\\.gz)?|annotations\\.csv(\\.gz)?|channels\\.csv(\\.gz)?|metadata\\.json)$/u;\n\n/**\n * Detect output from a previous run that this one did not replace.\n *\n * `--force` overwrites files but does not empty the directory, so converting a\n * mixed-rate recording and then a single-rate one into the same place leaves\n * `signals_256hz.csv` sitting next to a fresh `signals.csv`. Both look current.\n * Nothing is deleted here — the user is told, and decides.\n */\nasync function findStaleOutput(\n  outputDir: string,\n  written: readonly WrittenFile[],\n): Promise<Diagnostic[]> {\n  const entries = await readdir(outputDir).catch(() => null);\n  if (!entries) return [];\n\n  // metadata.json is rewritten on every run but is not part of the reported file list.\n  const fresh = new Set([...written.map((f) => f.name), 'metadata.json']);\n  const stale = entries.filter((name) => OUTPUT_PATTERN.test(name) && !fresh.has(name)).sort();\n  if (stale.length === 0) return [];\n\n  return [\n    {\n      code: 'STALE_OUTPUT',\n      severity: 'warning',\n      /*\n        Through `listed`, like every other message that enumerates something this run does not\n        control. How many stale files a directory holds is up to the directory, and a\n        mixed-rate recording converted into a reused one is exactly how it fills up: 120 old\n        `signals_<rate>hz.csv` files produced a single 2,373-character warning line. That is\n        the failure `listed` was written for — its own comment quotes the 1,600-character\n        version of it — and this was the one message still joining its own list.\n\n        The hint said \"Delete them\" whatever the count, so one stale file read \"signals_999hz\n        .csv is left over ... Delete them.\"\n      */\n      message:\n        `${listed(stale)} ${stale.length === 1 ? 'is' : 'are'} left over from an earlier ` +\n        `conversion into this directory and ${stale.length === 1 ? 'was' : 'were'} not rewritten.`,\n      hint:\n        `Delete ${stale.length === 1 ? 'it' : 'them'}, or convert into a fresh directory, so ` +\n        'the two runs do not get mixed up.',\n    },\n  ];\n}\n\nexport function defaultOutputDir(inputPath: string): string {\n  const base = path.basename(inputPath, path.extname(inputPath));\n  return path.join(path.dirname(inputPath), `${base}_csv`);\n}\n\n/** Never let an output target resolve to the recording being read, even with --force. */\nasync function assertInputDoesNotOverlapOutputs(\n  inputPath: string,\n  outputDir: string,\n  file: EdfFile,\n  plan: ConversionPlan,\n  options: ConvertOptions,\n): Promise<void> {\n  /*\n    The names this run will actually write, compressed ones included.\n\n    The rate files come from the plan and already carry `.csv.gz` under --gzip; the sidecars\n    were spelled out here and did not. So a compressed run checked two names it would never\n    write and missed the two it would: a recording sitting at <outdir>/channels.csv.gz was\n    overwritten by its own conversion, with --force, reported as a success. The same file\n    named signals.csv.gz was refused, which is what gives the oversight away.\n  */\n  const suffix = options.gzip === true ? '.csv.gz' : '.csv';\n  const names = new Set(plan.groups.map((group) => group.fileName));\n  if (file.annotationSignals.length > 0) names.add(`annotations${suffix}`);\n  names.add(`channels${suffix}`);\n  names.add('metadata.json');\n\n  const inputResolved = path.resolve(inputPath);\n  const inputInfo = await stat(inputPath);\n\n  for (const name of names) {\n    const target = path.join(outputDir, name);\n    const targetResolved = path.resolve(target);\n    const targetInfo = await stat(target).catch(() => null);\n    const samePath = targetResolved === inputResolved;\n    const sameFile =\n      targetInfo !== null && targetInfo.dev === inputInfo.dev && targetInfo.ino === inputInfo.ino;\n    if (!samePath && !sameFile) continue;\n\n    throw new ConversionError(\n      'INPUT_OUTPUT_COLLISION',\n      `Output file \"${target}\" is the same file as the input recording.`,\n      'Choose a separate directory with --out. The input was not modified.',\n    );\n  }\n}\n\nasync function prepareOutputDir(dir: string, force: boolean): Promise<void> {\n  /*\n    Claim the directory with a single atomic mkdir rather than asking whether it exists\n    and then creating it.\n\n    Checking first left a window between the two: two conversions started together both\n    saw \"not there\", both proceeded, and both opened write streams on the same signals.csv.\n    Neither reported anything — both exited 0, having half-written one file between them.\n    A non-recursive mkdir cannot do that. Exactly one caller creates the directory; every\n    other one gets EEXIST from the filesystem and takes the already-exists path below.\n\n    Parents are still created recursively, since --out ./a/b/c should work. Only the final\n    component is the claim.\n  */\n  const parent = path.dirname(dir);\n  if (parent && parent !== dir) {\n    try {\n      await mkdir(parent, { recursive: true });\n    } catch (cause: unknown) {\n      // A parent that is a regular file surfaces as EEXIST naming the parent, which reads\n      // as though the destination already exists rather than as \"you cannot put a\n      // directory inside a file\". Name the real obstacle instead of the errno.\n      const info = await stat(parent).catch(() => null);\n      if (info && !info.isDirectory()) {\n        throw new ConversionError(\n          'OUTPUT_UNWRITABLE',\n          `Cannot create \"${dir}\": \"${parent}\" is a file, not a directory.`,\n          'Choose a destination whose parent directories are directories, with --out.',\n        );\n      }\n      throw new ConversionError(\n        'OUTPUT_UNWRITABLE',\n        `Cannot create \"${dir}\": ${describeFsError(cause)}.`,\n        'Check the path exists and that you have permission to write there.',\n      );\n    }\n  }\n\n  let claimed = true;\n  try {\n    await mkdir(dir);\n  } catch (cause: unknown) {\n    if ((cause as NodeJS.ErrnoException).code !== 'EEXIST') {\n      throw new ConversionError(\n        'OUTPUT_UNWRITABLE',\n        `Cannot create \"${dir}\": ${describeFsError(cause)}.`,\n        'Check the path exists and that you have permission to write there.',\n      );\n    }\n    claimed = false;\n  }\n\n  if (!claimed) {\n    const existing = await stat(dir).catch(() => null);\n\n    // --force means \"replace my previous output\", not \"write output files into\n    // whatever this happens to be\". Pointing it at a regular file needs saying so.\n    if (existing && !existing.isDirectory()) {\n      throw new ConversionError(\n        'OUTPUT_UNWRITABLE',\n        `\"${dir}\" is a file, but the converted data needs a directory.`,\n        'Choose a directory with --out.',\n      );\n    }\n    if (!force) {\n      throw new ConversionError(\n        'OUTPUT_EXISTS',\n        `\"${dir}\" already exists.`,\n        'Pass --force to overwrite it, or --out to choose a different directory.',\n      );\n    }\n  }\n}\n\n/** Turn a Node filesystem error into something a person can act on. */\nfunction describeFsError(cause: unknown): string {\n  const code = (cause as NodeJS.ErrnoException | undefined)?.code;\n  if (code === 'EACCES' || code === 'EPERM') return 'permission denied';\n  if (code === 'ENOSPC') return 'the disk is full';\n  // The one that actually happens on a shared filesystem, and the one this list left out.\n  if (code === 'EDQUOT') return 'you are over your disk quota on this filesystem';\n  if (code === 'ENOTDIR') return 'part of the path is a file, not a directory';\n  if (code === 'EROFS') return 'the filesystem is read-only';\n  if (code === 'ENAMETOOLONG') return 'the path is too long';\n  /*\n    The one this list could not describe, and the recursive mkdir above is what makes it\n    surprising: every parent is created on the way, so \"no such file or directory\" is not a\n    parent that was missing. It is a component that exists and leads nowhere — a symbolic\n    link with no target is the way to get one — or a directory removed by something else\n    between the two calls.\n\n    Missing it meant the fallback ran, which is Node's own text, complete with the internal\n    call that raised it:\n\n        error: Cannot create \"dangle/x\": ENOENT: no such file or directory, mkdir 'dangle'.\n               Check the path exists and that you have permission to write there.\n\n    Keeping that off the screen is the whole purpose of the six lines above it.\n  */\n  if (code === 'ENOENT') return 'part of the path does not exist';\n  return cause instanceof Error ? cause.message : String(cause);\n}\n\nasync function writeSignalFiles(\n  file: EdfFile,\n  plan: ConversionPlan,\n  outputDir: string | null,\n  recordStarts: Float64Array | null,\n  options: ConvertOptions,\n  onHangUp?: (hungUp: boolean) => void,\n): Promise<WrittenFile[]> {\n  // One budget for every table in this conversion, not one per table: see OffsetBudget.\n  const offsets = newOffsetBudget();\n  // Likewise one for every channel, not one per channel: see SampleCacheBudget.\n  const sampleCaches = newSampleCacheBudget();\n  // Only the stdout path needs this; --out finds a full disk on its own, because it always\n  // has another file to write afterwards. See auditStdout.\n  const audit = outputDir === null ? auditStdout() : null;\n  /*\n    In the long layout every group writes into one table, so they share one stream. Opening\n    a stream per group on the same path is what the rate-slug collision fix in groupByRate\n    was about: two writers on one file interleave rows under a header naming one of them.\n  */\n  let shared: {\n    stream: Writable;\n    settled: Promise<void>;\n    release: () => void;\n    target: Writable;\n    writer: BufferedLineWriter;\n  } | null = null;\n\n  /*\n    One buffer's worth of memory for the conversion, not one per table.\n\n    Every group had its own writer at the default 1 MiB threshold, so pending output was\n    group count × 1 MiB before anything drained. A 6.5 MB recording with 40 sampling rates\n    — the header allows thousands of channels, and a research montage really does mix a\n    dozen rates — died with a raw V8 heap out-of-memory and exit 134 under a 96 MB cap,\n    while the site advertises 48 MB. The recording is small; it is the fan-out that is not.\n\n    Split evenly with a floor, so the single-rate case, which is nearly every recording,\n    keeps exactly the buffer it always had, and forty tables cost one megabyte between them\n    rather than forty. The floor is what the sum is bounded by rather than the split: past\n    128 groups every table takes the 8 KiB minimum, so the total grows again from there.\n    The long layout shares one writer already and is unaffected either way.\n  */\n  const MIN_FLUSH_THRESHOLD = 8 * 1024;\n  const flushThreshold = Math.max(\n    MIN_FLUSH_THRESHOLD,\n    Math.floor(DEFAULT_FLUSH_THRESHOLD / Math.max(1, plan.groups.length)),\n  );\n  /*\n    The stream's own buffer is the other half of the same sum.\n\n    0.5.6 shared the line-buffer budget and left `createWriteStream` at its 64 KiB default,\n    which is per stream: 200 rate groups meant 12.8 MB of stream buffer on top of 12.8 MB of\n    line buffer, and an 855 KB recording still died at a 48 MB cap. Shared the same way, with\n    a floor that keeps an ordinary conversion writing in useful-sized pieces.\n  */\n  const streamBuffer = Math.max(\n    16 * 1024,\n    Math.floor(DEFAULT_FLUSH_THRESHOLD / Math.max(1, plan.groups.length)),\n  );\n\n  const open: OpenGroup[] = plan.groups.map((group, groupIndex) => {\n    // A null directory means the single table goes to stdout. process.stdout is already a\n    // writable stream, so the same buffered writer and backpressure handling apply.\n    const target =\n      shared?.target ??\n      (outputDir === null\n        ? process.stdout\n        : createWriteStream(path.join(outputDir, group.fileName), {\n            highWaterMark: streamBuffer,\n          }));\n    const { stream, settled, release } = shared ?? compressed(target, options.gzip === true);\n    /*\n      Under --gzip the writer feeds the compressor, so its byte count is the CSV before\n      compression and says nothing about what reached the descriptor. The compressor's own\n      output is what stdout is handed, so that is what is counted. `pipe` uses a 'data'\n      listener of its own and a second one is delivered the same chunks.\n\n      Once per stream, which in the long layout is once for all the groups. Attaching per\n      group put N listeners on the one shared compressor, so every chunk was counted N\n      times: `--stdout --layout long --gzip` on a 40-rate recording claimed 622,240 of\n      622,240 bytes where 15,556 had been written, failed with a disk-full error over a\n      perfectly good file, and printed Node's MaxListenersExceededWarning to stderr on the\n      way past ten. 0.5.4 fixed the same arithmetic in the uncompressed branch and left\n      this one, because the uncompressed branch is where the count is a sum and this one is\n      where it is a subscription.\n    */\n    if (audit && stream !== target && !shared) {\n      stream.on('data', (chunk: Buffer) => audit.count(chunk.length));\n    }\n    /*\n      One writer, not one per group, when the table is shared. Separate writers over one\n      stream each hold their own buffer and flush on their own schedule, so the rows would\n      reach the file in whatever order the buffers filled — which is not the order they\n      were produced in, and the long layout's whole claim is that its rows are in time\n      order.\n    */\n    const writer = shared?.writer ?? new BufferedLineWriter(stream, flushThreshold);\n    if (plan.layout === 'long' && !shared) shared = { stream, settled, release, target, writer };\n\n    // Only the first group writes the header of a shared table, and the mark before it.\n    if (plan.layout !== 'long' || groupIndex === 0) {\n      if (options.bom === true) writer.push(UTF8_BOM);\n      writer.pushLine(\n        plan.layout === 'long'\n          ? csvRow([TIME_COLUMN, 'channel', 'value'])\n          : csvRow([TIME_COLUMN, ...group.channels.map((c) => c.column)]),\n      );\n    }\n    return {\n      group,\n      writer,\n      formatters: group.channels.map((c) => makeSampleFormatter(c.signal, c.decimals, sampleCaches)),\n      formatTime: makeTimeFormatter(\n        group.samplesPerRecord,\n        group.rate,\n        group.timeDecimals,\n        offsets,\n      ),\n      rows: 0,\n      settled,\n      release,\n    };\n  });\n\n  try {\n    const written = await streamSignalRows(file, plan, open, recordStarts, options);\n\n    /*\n      Checked once everything has been flushed and ended, and not when the reader hung up.\n\n      `--stdout | head -1` closes the pipe on purpose, which is a shell idiom rather than a\n      failure. A pipe is not a regular file, so auditStdout declines it anyway — the second\n      guard is here because the cost of getting this one wrong is reporting a failure for a\n      command that worked.\n    */\n    if (audit) {\n      // Uncompressed, the writer hands its bytes straight to the descriptor; compressed,\n      // they were counted on the compressor's way out.\n      if (options.gzip !== true) {\n        /*\n          Once per writer, not once per group. The long layout gives every group the same\n          writer, so counting per group multiplied its byte total by the number of rates:\n          `--stdout --layout long` on a three-rate recording handed over 32,043 bytes, was\n          credited with 96,129, and failed with a disk-full error for a file that was\n          complete on disk. It only showed with stdout redirected to a regular file, since\n          that is the one case the audit applies to — which is the command the --layout\n          documentation gives.\n        */\n        for (const writer of new Set(open.map((entry) => entry.writer))) {\n          audit.count(writer.bytesOut);\n        }\n      }\n      if (!open.some((entry) => entry.writer.hungUp)) audit.verify();\n    }\n    onHangUp?.(open.some((entry) => entry.writer.hungUp));\n    return written;\n  } catch (cause) {\n    for (const entry of open) entry.writer.destroy();\n\n    /*\n      Reading and writing both fail through here, and both were reported as writing.\n\n      A recording that shrinks mid-conversion — still being written by the acquisition\n      software, say — raises the reader's own error, which names the record and says the\n      file changed size while it was being read. That precise diagnosis was then filed under\n      `Writing to \"<dir>\" failed` and given the hint about freeing disk space, which sends\n      someone to look at the one part of the system that was working.\n\n      The reader's message and its advice are kept; only the note about partial output is\n      added, since that much is true of either failure.\n    */\n    // A ConversionError arrived already saying what went wrong — a callback that threw, say.\n    // Wrapping it again turned \"the onProgress callback threw\" into `Writing to \"out\"\n    // failed: the onProgress callback threw`, under a hint about checking the destination.\n    if (cause instanceof ConversionError) throw cause;\n\n    if (cause instanceof EdfError) {\n      const where = outputDir === null ? 'stdout' : `\"${outputDir}\"`;\n      throw new ConversionError(\n        'INPUT_UNREADABLE',\n        cause.message,\n        `${cause.hint ? `${cause.hint} ` : ''}What was written to ${where} before it failed is ` +\n          `incomplete and should not be used.`,\n      );\n    }\n\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new ConversionError(\n      'WRITE_FAILED',\n      `Writing to ${outputDir === null ? 'stdout' : `\"${outputDir}\"`} failed: ${detail}`,\n      writeHint(cause, outputDir === null),\n    );\n  }\n}\n\n/**\n * One record's samples in the long layout: `time_s,channel,value`, in time order.\n *\n * The groups are merged rather than written one after another. Every sample in a record\n * falls inside that record's span, so taking the earliest next sample across the groups\n * each time leaves the whole file sorted by `time_s` — which is the only thing that makes a\n * mixed-rate long table useful, since sorting 3 million rows afterwards is the reader's\n * problem and a large one.\n *\n * Ties go to the group with the higher rate, which is the order the groups are already in.\n * Within a sample time the channels come out in the order the file declares them.\n */\n/**\n * Whether two sample times are close enough that only rounding could separate them.\n *\n * A relative epsilon, because the gap between doubles grows with magnitude. Well below any\n * real sample interval — the finest a recording can declare is bounded by its record\n * duration and samples-per-record fields — and well above the one-ULP disagreement that two\n * exact divisions of the same instant produce.\n */\nfunction nearlyEqual(a: number, b: number): boolean {\n  return Math.abs(a - b) <= Math.max(Math.abs(a), Math.abs(b)) * 1e-12;\n}\n\nasync function writeLongRecord(\n  file: EdfFile,\n  open: readonly OpenGroup[],\n  batch: RecordBatch,\n  recordInBatch: number,\n  recordStart: number,\n  range: ConversionPlan['range'],\n): Promise<void> {\n  const writer = open[0]?.writer;\n  if (!writer) return;\n\n  const cursors = new Int32Array(open.length);\n  /* Reused across sample times so a three-million-row conversion allocates one of these. */\n  const due: { entry: OpenGroup; groupIndex: number; sample: number; channel: number }[] = [];\n\n  for (;;) {\n    let earliest = Infinity;\n    let source = -1;\n    let sourceSample = 0;\n    for (let g = 0; g < open.length; g++) {\n      const entry = open[g];\n      if (!entry) continue;\n      const sample = cursors[g] ?? 0;\n      if (sample >= entry.group.samplesPerRecord) continue;\n      const time = recordStart + sample / entry.group.rate;\n      if (time < earliest) {\n        earliest = time;\n        source = g;\n        sourceSample = sample;\n      }\n    }\n    if (earliest === Infinity) return;\n\n    /*\n      Everything at this instant, in the order the file declares its channels.\n\n      Groups are ordered by rate, largest first, because that is how the wide layout names\n      its files. Emitting a tie group by group therefore ordered the channels by descending\n      sampling rate — so a recording declaring `slow, medium, fast` wrote `fast, medium,\n      slow`, while the documentation promised file order and channels.csv listed file order.\n      Signal index is the file's own order, and the only one a reader can predict.\n\n      \"At this instant\" is decided on the time as written, not on the double. `s / rate` for\n      two channels at one moment need not give the same double: a 0.3 s record holding 12 and\n      4 samples makes 40 Hz and 13.333… Hz, and 9/40 is 0.22500000000000000555 while 3/13.333…\n      is 0.22499999999999997780. Equality missed that, so those two rows fell out in numeric\n      order — `slow` before `fast`, once, in the middle of a file that was otherwise right.\n\n      Two rows are at one time exactly when they carry the same `time_s`, which is the only\n      definition a reader of the CSV can apply. The numeric pre-filter keeps the common case\n      to one comparison; formatting happens only for candidates already within a hair.\n    */\n    let earliestText: string | null = null;\n    /*\n      Formatted on the first near-tie and not before, which on a single-rate table is never.\n\n      The group and sample that set `earliest` are captured above rather than searched for\n      again, since the loop below advances cursors as it goes and a later search would be\n      looking at a table that had already moved on.\n    */\n    const asWritten = (): string =>\n      (earliestText ??= open[source]?.formatTime(recordStart, sourceSample) ?? '');\n    due.length = 0;\n    for (let g = 0; g < open.length; g++) {\n      const entry = open[g];\n      if (!entry) continue;\n      const sample = cursors[g] ?? 0;\n      if (sample >= entry.group.samplesPerRecord) continue;\n      const time = recordStart + sample / entry.group.rate;\n      if (time !== earliest) {\n        // Far away in the ordinary case; only a near-tie is worth formatting.\n        if (!nearlyEqual(time, earliest)) continue;\n        if (entry.formatTime(recordStart, sample) !== asWritten()) continue;\n      }\n      cursors[g] = sample + 1;\n      // Same window rule as the wide layout, with the same per-rate slack.\n      if (\n        !sampleTimeIsInRange(earliest, range.startSeconds, range.endSeconds, toleranceFor(entry.group.rate))\n      ) {\n        continue;\n      }\n      for (let c = 0; c < entry.group.channels.length; c++) {\n        due.push({ entry, groupIndex: g, sample, channel: c });\n      }\n    }\n    if (due.length === 0) continue;\n    if (due.length > 1) {\n      due.sort(\n        (a, b) =>\n          (a.entry.group.channels[a.channel]?.signal.index ?? 0) -\n          (b.entry.group.channels[b.channel]?.signal.index ?? 0),\n      );\n    }\n\n    for (const item of due) {\n      const channel = item.entry.group.channels[item.channel];\n      const format = item.entry.formatters[item.channel];\n      if (!channel || !format) continue;\n      if (writer.hungUp) return;\n      writer.pushLine(\n        `${item.entry.formatTime(recordStart, item.sample)},${escapeCsvField(channel.column)},` +\n          `${format(file.sampleAt(batch, recordInBatch, channel.signal, item.sample))}`,\n      );\n      item.entry.rows++;\n      // Flushed inside the record for the same reason the wide layout is; see there.\n      if (writer.full) await writer.flush();\n    }\n  }\n}\n\nasync function streamSignalRows(\n  file: EdfFile,\n  plan: ConversionPlan,\n  open: OpenGroup[],\n  recordStarts: Float64Array | null,\n  options: ConvertOptions,\n): Promise<WrittenFile[]> {\n  const { startSeconds, endSeconds, startRecord, endRecord } = plan.range;\n  const { recordDuration } = file.header;\n  let recordsDone = 0;\n\n  /*\n    Every destination has hung up, so nothing formatted from here on could reach anyone.\n    `--stdout | head -1` is the usual way to arrive here: the reader takes one line and\n    closes the pipe while the conversion is still near the start of the recording.\n\n    Stopping also makes the reported row count mean what it says — rows that reached the\n    consumer, rather than rows the loop went on formatting into a discarded buffer.\n  */\n  const allHungUp = (): boolean => open.length > 0 && open.every((entry) => entry.writer.hungUp);\n\n  for await (const batch of file.readRecords({ startRecord, endRecord })) {\n    if (allHungUp()) break;\n    for (let r = 0; r < batch.recordCount; r++) {\n      if (allHungUp()) break;\n      const index = batch.firstRecordIndex + r;\n      const recordStart = recordStarts ? (recordStarts[index] ?? index * recordDuration) : index * recordDuration;\n\n      if (plan.layout === 'long') {\n        await writeLongRecord(file, open, batch, r, recordStart, plan.range);\n        recordsDone++;\n        continue;\n      }\n\n      for (const entry of open) {\n        const { group, writer, formatters, formatTime } = entry;\n        const { channels, rate } = group;\n        // Slack that never reaches the next sample; see toleranceFor.\n        const slack = toleranceFor(rate);\n\n        for (let sample = 0; sample < group.samplesPerRecord; sample++) {\n          const time = recordStart + sample / rate;\n          if (!sampleTimeIsInRange(time, startSeconds, endSeconds, slack)) continue;\n\n          let row = formatTime(recordStart, sample);\n          for (let c = 0; c < channels.length; c++) {\n            const channel = channels[c];\n            const format = formatters[c];\n            if (!channel || !format) continue;\n            row += ',' + format(file.sampleAt(batch, r, channel.signal, sample));\n          }\n          if (writer.hungUp) break;\n          writer.pushLine(row);\n          entry.rows++;\n\n          /*\n            Flushed inside the record, not only at the end of one.\n\n            The buffer was drained once per record, so the rows of a single record piled up\n            with nothing emptying them — memory followed samples-per-record rather than the\n            batch size the writer exists to hold to. One record of 16,000,000 samples died\n            with a heap out of memory under a 256 MB cap, while the same 32 MB of samples\n            split into 16,000 records converted to the same 283 MB CSV without trouble. The\n            format allows either layout and says nothing about which to expect.\n\n            `full` is a synchronous read of the pending size, so the twenty million rows that\n            are not at a boundary cost a comparison rather than a microtask each.\n          */\n          if (writer.full) await writer.flush();\n        }\n        await writer.maybeFlush();\n      }\n\n      recordsDone++;\n    }\n\n    if (options.onProgress) {\n      /*\n        A caller's callback is the caller's, and its failures are not the destination's.\n\n        This ran inside the same try that turns a stream failure into WRITE_FAILED, so a\n        progress callback that threw came back as `Writing to \"out\" failed: caller bug`,\n        advising the reader to check a destination that was working perfectly. It is the\n        same misattribution the write hints had until 0.4.36, one layer up.\n\n        The original is kept as `cause`, so the stack that actually matters survives, and\n        the conversion still stops — the callback threw, and carrying on writing into a\n        directory whose owner has just failed is not an improvement.\n      */\n      try {\n        options.onProgress({\n          recordsDone,\n          recordsTotal: endRecord - startRecord,\n          // Once per writer: the long layout's groups share one, so summing per group\n          // reported a figure larger than the file being written.\n          bytesWritten: [...new Set(open.map((entry) => entry.writer))].reduce(\n            (sum, entry) => sum + entry.charsWritten,\n            0,\n          ),\n        });\n      } catch (cause) {\n        throw new ConversionError(\n          'CALLBACK_FAILED',\n          `The onProgress callback threw: ${cause instanceof Error ? cause.message : String(cause)}`,\n          'This is the caller\\'s callback, not the recording or the destination. Whatever was ' +\n            'written before it threw is incomplete and should not be used.',\n          { cause },\n        );\n      }\n    }\n  }\n\n  const closed = new Set<BufferedLineWriter>();\n  for (const entry of open) {\n    if (closed.has(entry.writer)) continue;\n    closed.add(entry.writer);\n    try {\n      await entry.writer.end();\n      // With --gzip the writer's stream is the compressor, whose end callback fires when the\n      // compressor is done rather than when the file behind it is. Awaiting only that would\n      // report success with the tail of the file still in flight.\n      await entry.settled;\n    } finally {\n      // In a finally for the reason 0.5.45 gives about the writer's own release: a\n      // conversion that fails here still has to leave process.stdout as it found it, and a\n      // failure is exactly when a caller goes on to convert something else.\n      entry.release();\n    }\n  }\n\n  // A shared table is one file, and its row count is every group's rows, not the first's.\n  if (plan.layout === 'long') {\n    const first = open[0];\n    if (!first) return [];\n    return [{ name: first.group.fileName, rows: open.reduce((sum, e) => sum + e.rows, 0) }];\n  }\n  return open.map((entry) => ({ name: entry.group.fileName, rows: entry.rows }));\n}\n\n/**\n * The stream rows are written to, plus a promise for the data reaching its destination.\n *\n * Compression sits between the writer and the file as a transform. Failures below it — a\n * full disk, an unwritable path — surface on the file stream, where nothing is listening,\n * so they are forwarded onto the compressor: that is the stream the writer watches, and\n * routing them there keeps one error path rather than two.\n */\nfunction compressed(\n  target: Writable,\n  gzip: boolean,\n): { stream: Writable; settled: Promise<void>; release: () => void } {\n  if (!gzip) return { stream: target, settled: Promise.resolve(), release: (): void => {} };\n  const compressor = createGzip();\n  /*\n    Removable, because one of the streams this can be handed outlives the conversion.\n\n    0.5.36 fixed exactly this leak for the writer's own listener: a library caller running\n    twelve `toStdout` conversions left twelve 'error' listeners on `process.stdout` and got\n    Node's MaxListenersExceededWarning on the eleventh. That fix is `BufferedLineWriter`'s\n    `#release()`, and it cannot reach this one — under `gzip` the writer's stream is the\n    compressor, and `process.stdout` is only ever the compressor's destination. So the same\n    leak survived on the same stream, behind one extra flag, and the regression test written\n    to catch it does not pass `gzip: true`.\n\n    A file stream is a different matter and needs no release: it is created for this\n    conversion and closed with it. The discipline is the writer's — release only from a\n    stream this tool does not own.\n  */\n  const forward = (error: Error): void => {\n    compressor.destroy(error);\n  };\n  target.on('error', forward);\n  const release = (): void => {\n    if (target === process.stdout || target === process.stderr) target.off('error', forward);\n  };\n\n  /*\n    pipe() ends its destination when the source ends, and stdout must survive the\n    conversion: the writer already refuses to close it, because a closed stdout breaks\n    every later write in the process. Nothing waits on stdout either — it is not this\n    tool's to finish.\n  */\n  const toStdout = target === process.stdout;\n  compressor.pipe(target, { end: !toStdout });\n  if (toStdout) {\n    /*\n      Waited on, even though stdout is not ours to end.\n\n      This returned an already-resolved promise, so `await entry.settled` waited for nothing\n      and the conversion declared itself finished while the compressor still held the tail of\n      the stream. `--stdout --gzip` onto a destination that filled up therefore printed the\n      ENOSPC *and then* \"Wrote 102,400 rows to stdout.\" — and exited 0, over a file 11,270\n      bytes short whose gzip member has no trailer and will not decompress. Through `--out`,\n      on the same volume with the same space, the identical failure is reported and exits 1.\n\n      The byte audit could not see it either: it stats the descriptor as soon as the writers\n      are done, which on this path is before the compressor has pushed its last chunks.\n\n      `finished(compressor)` is the source side, not the destination — it resolves when the\n      compressor has flushed everything into stdout, and it is stdout's own write that fails.\n      That keeps `end: !toStdout` exactly as it was: nothing here closes stdout.\n    */\n    const flushed = finished(compressor).catch((error: unknown) => {\n      /*\n        EPIPE is not a failure here, and turning it into one is the trap this nearly fell\n        into: `--stdout --gzip | head` is an ordinary thing to type, and the documented\n        answer to it is \"Stopped: the reader closed the pipe after 52,507 of 102,400 rows\n        had been written\", exit 0. Waiting on the compressor surfaced the EPIPE that the\n        uncompressed path already routes through the writer's hang-up flag — the writer\n        sees the same error, forwarded, and records it — so the wait has to let that one\n        through and keep everything else.\n      */\n      if ((error as NodeJS.ErrnoException | null)?.code === 'EPIPE') return;\n      throw error;\n    });\n    flushed.catch(() => {});\n    return { stream: compressor, settled: flushed, release };\n  }\n\n  /*\n    A failure under the compressor rejects both this promise and the writer's own end(),\n    and end() is the one awaited first. Without a handler attached here that rejection\n    belonged to nobody, and Node killed the process over it: `--gzip` into an unwritable\n    path printed a raw EISDIR stack trace instead of the ordinary \"Writing to ... failed\"\n    message and exit 1, which is what the same path does uncompressed.\n\n    Attaching the handler is enough to make it handled. Awaiting `settled` downstream still\n    reports the failure in the case where end() happened to succeed.\n  */\n  const settled = finished(target);\n  settled.catch(() => {});\n  return { stream: compressor, settled, release };\n}\n\n/**\n * Write one of the sidecar files, reporting a failure the way the signal writer does.\n *\n * These three used to call `writeFile` bare, so a failure escaped as whatever the\n * filesystem said — `EISDIR: illegal operation on a directory, open '...'` with no hint\n * and, more importantly, no mention that the signal files had already been written. The\n * conversion stopped half-done and the message gave no sign of it.\n */\nasync function writeOutputFile(\n  outputDir: string,\n  name: string,\n  contents: string,\n  gzip = false,\n  bom = false,\n): Promise<void> {\n  // metadata.json never gets one: JSON.parse rejects a leading U+FEFF, so a mark there\n  // would break every reader of the file to help a spreadsheet that will not open it.\n  if (bom) contents = UTF8_BOM + contents;\n  try {\n    // The sidecars are built in memory before being written, so compressing them in memory\n    // costs nothing extra. Only the signal tables are large enough to need a stream.\n    await writeFile(path.join(outputDir, name), gzip ? gzipSync(contents) : contents, gzip ? undefined : 'utf8');\n  } catch (cause) {\n    const detail = cause instanceof Error ? cause.message : String(cause);\n    throw new ConversionError(\n      'WRITE_FAILED',\n      `Writing \"${name}\" to \"${outputDir}\" failed: ${detail}`,\n      writeHint(cause),\n    );\n  }\n}\n\nasync function writeChannelsCsv(\n  outputDir: string,\n  file: EdfFile,\n  plan: ConversionPlan,\n  gzip: boolean,\n  bom: boolean,\n): Promise<WrittenFile> {\n  const includedColumns = new Set(plan.groups.flatMap((g) => g.channels.map((c) => c.signal.index)));\n  const fileFor = new Map<number, string>();\n  for (const group of plan.groups) {\n    for (const channel of group.channels) fileFor.set(channel.signal.index, group.fileName);\n  }\n\n  const lines = [\n    csvRow([\n      'column',\n      'signal_index',\n      'label',\n      'unit',\n      'sampling_rate_hz',\n      'samples_per_record',\n      'physical_min',\n      'physical_max',\n      'digital_min',\n      'digital_max',\n      'transducer',\n      'prefiltering',\n      'output_file',\n      'converted',\n    ]),\n  ];\n\n  for (const signal of file.header.signals) {\n    if (signal.isAnnotations) continue;\n    const column = plan.columnNames.get(signal.index) ?? `signal_${signal.index}`;\n    lines.push(\n      csvRow([\n        column,\n        String(signal.index),\n        signal.label,\n        signal.physicalDimension,\n        String(signal.samplingRate),\n        String(signal.samplesPerRecord),\n        String(signal.physicalMin),\n        String(signal.physicalMax),\n        String(signal.digitalMin),\n        String(signal.digitalMax),\n        signal.transducer,\n        signal.prefiltering,\n        fileFor.get(signal.index) ?? '',\n        includedColumns.has(signal.index) ? 'yes' : 'no',\n      ]),\n    );\n  }\n\n  const name = gzip ? 'channels.csv.gz' : 'channels.csv';\n  await writeOutputFile(outputDir, name, lines.join('\\n') + '\\n', gzip, bom);\n  return { name, rows: lines.length - 1 };\n}\n\n/*\n  The bounds an annotation is filtered against: what the caller actually asked for, not the\n  window that survived being clamped to the recording.\n\n  Filtering by the resolved window meant an unbounded request still lost events. `--end 999h`\n  on a three-second file clamps to 3, and `--start 0` gets its end from the recording, so\n  both filtered to [0, 3) and dropped the markers at 3.0 and 3.5 that a bare invocation\n  keeps — asking for more of a recording returned less of it.\n\n  An end the caller did not give is unbounded, not \"the end of the data\": EDF+ lets an\n  annotation sit past the last sample, which is exactly where an end-of-recording marker is.\n\n  `--duration` is measured from wherever the conversion actually starts. Anchoring it at 0\n  instead read the same absent `--start` two ways in two adjacent lines, and on a recording\n  that does not begin at zero the two windows did not even overlap: an EDF+D file whose first\n  record sits at 30 s converted its samples from [30, 35) while filtering annotations against\n  (-inf, 5), so every event inside the converted window was dropped and `annotations.csv` came\n  back empty. `resolveRange` has always defaulted the same missing start to the earliest\n  record, which is where this now takes it from.\n*/\n/**\n * What the durations in the events that will actually be written look like.\n *\n * These two warnings were raised from the file-wide counts the decoder accumulates, while\n * `annotations.csv` is filtered to the requested window. A conversion of one second of a\n * recording therefore warned that \"1 annotation states a duration that is not a number, so\n * its duration_s cell is empty\" about an event two seconds outside it — naming a cell that is\n * not in the output — and `--strict` failed the run for it. There is no such value, no such\n * cell, and no such row.\n *\n * Taken from the events themselves, after the same filter the writer applies, so the count\n * and the sentence describe the same rows. An unreadable duration is carried on the event\n * because `duration: null` cannot say whether the file gave one; a negative duration needs no\n * flag, since the value is right there.\n */\nexport function durationDiagnostics(\n  annotations: readonly Annotation[],\n  window: { from: number; to: number },\n): Diagnostic[] {\n  const written = annotations.filter((a) => a.onset >= window.from && a.onset < window.to);\n  const diagnostics: Diagnostic[] = [];\n\n  const negative = written.filter((a) => a.duration !== null && a.duration < 0).length;\n  if (negative > 0) {\n    const one = negative === 1;\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${negative} annotation${one ? '' : 's'} state${one ? 's' : ''} a duration below zero, ` +\n        `which is not a length of time.`,\n      hint:\n        'The value is written to annotations.csv as the file gave it. Adding it to onset_s ' +\n        'ends the event before it starts, so check these rows before using the durations.',\n    });\n  }\n\n  const unreadable = written.filter((a) => a.durationUnreadable === true).length;\n  if (unreadable > 0) {\n    const one = unreadable === 1;\n    diagnostics.push({\n      code: 'ANNOTATION_DECODE_FAILED',\n      severity: 'warning',\n      message:\n        `${unreadable} annotation${one ? '' : 's'} state${one ? 's' : ''} a duration that is ` +\n        `not a number, so ${one ? 'its' : 'their'} duration_s cell is empty.`,\n      hint:\n        'The onset and the description were read normally. An empty duration_s otherwise ' +\n        'means the file stated no duration, so these rows cannot be told apart from those.',\n    });\n  }\n\n  return diagnostics;\n}\n\n/**\n * The window annotations are filtered by — the bounds as asked for, not as snapped to records.\n *\n * Exported so `--info` can count the events a conversion would write using the same predicate\n * that writes them, rather than a second copy of it.\n */\nexport function requestedAnnotationWindow(\n  options: ConvertOptions,\n  recordingStart: number,\n): { from: number; to: number } {\n  const from = options.start ?? -Infinity;\n  const to =\n    options.end !== undefined\n      ? options.end\n      : options.duration !== undefined\n        ? (options.start ?? recordingStart) + options.duration\n        : Infinity;\n  return { from, to };\n}\n\nasync function writeAnnotationsCsv(\n  outputDir: string,\n  annotations: readonly Annotation[],\n  window: { from: number; to: number },\n  gzip: boolean,\n  bom: boolean,\n): Promise<WrittenFile> {\n  const inWindow = annotations\n    .filter((a) => a.onset >= window.from && a.onset < window.to)\n    .sort((a, b) => a.onset - b.onset || a.recordIndex - b.recordIndex);\n\n  const lines = [csvRow(['onset_s', 'duration_s', 'description', 'record_index'])];\n  for (const annotation of inWindow) {\n    lines.push(\n      csvRow([\n        plain(annotation.onset),\n        annotation.duration === null ? '' : plain(annotation.duration),\n        annotation.text,\n        String(annotation.recordIndex),\n      ]),\n    );\n  }\n\n  const name = gzip ? 'annotations.csv.gz' : 'annotations.csv';\n  await writeOutputFile(outputDir, name, lines.join('\\n') + '\\n', gzip, bom);\n  return { name, rows: inWindow.length };\n}\n\n/**\n * What to try next, chosen from what actually went wrong.\n *\n * Every write failure carried the same advice — \"Free up space or choose another destination\n * with --out\" — which fits exactly one errno. A directory sitting where signals.csv belongs\n * came back telling the reader to free up disk space, and so did a read-only volume, a\n * permission denial and a path too long for the filesystem. Wrong advice is worse than none:\n * it sends someone to check `df` on a disk that is fine, and the thing that is actually\n * wrong stays unexamined.\n *\n * The errno is the one piece of the failure that names the cause, so it is what picks the\n * sentence. Anything unrecognised keeps the general form rather than guessing.\n */\nfunction writeHint(cause: unknown, toStdout = false): string {\n  /*\n    The stdout path writes no files, and --out is the flag its user chose not to pass.\n\n    Both halves of this sentence were wrong there: \"the files written so far\" named files\n    that do not exist, and \"choose another destination with --out\" is advice for a different\n    command — the destination is whatever the shell redirected the stream to. Same class as\n    the disk-space hint this function replaced, one flag over.\n  */\n  const preamble = toStdout\n    ? 'What reached stdout before it failed is incomplete and should not be used. '\n    : 'The files written so far are incomplete and should not be used. ';\n  const elsewhere = toStdout ? 'redirect it somewhere else' : 'choose another with --out';\n  const code = (cause as NodeJS.ErrnoException | null)?.code;\n  switch (code) {\n    case 'ENOSPC':\n      return `${preamble}The destination is out of space; free some up or ${elsewhere}.`;\n    case 'EDQUOT':\n      return `${preamble}You are over your disk quota on this filesystem; ${elsewhere}.`;\n    case 'EACCES':\n    case 'EPERM':\n      return `${preamble}You do not have permission to write there; ${elsewhere}.`;\n    case 'EROFS':\n      return `${preamble}That filesystem is mounted read-only; ${elsewhere}.`;\n    case 'EISDIR':\n      return `${preamble}A directory is sitting where that file belongs; remove or rename it, or ${elsewhere}.`;\n    case 'ENOENT':\n      return `${preamble}Part of that path no longer exists; make sure nothing is removing it while the conversion runs.`;\n    case 'ENAMETOOLONG':\n      return `${preamble}That path is longer than the filesystem allows; ${toStdout ? 'redirect it somewhere shorter' : 'choose a shorter destination with --out'}.`;\n    case 'EMFILE':\n    case 'ENFILE':\n      return `${preamble}Too many files are open; a recording with many sampling rates opens one output file per rate, so --channels narrows it.`;\n    case 'EPIPE':\n      return `${preamble}Whatever was reading the output closed it before the conversion finished.`;\n    default:\n      return `${preamble}Check the destination and run the conversion again.`;\n  }\n}\n\n/**\n * Confirms that everything handed to a file-backed stdout actually arrived.\n *\n * `edf2csv rec.edf --stdout > out.csv` onto a volume that the output very nearly fills lost\n * the tail in silence: 94,977 of 102,400 rows on disk, the file ending mid-row, stderr\n * announcing \"Wrote 102,400 rows to stdout.\" and the process exiting 0. The same recording\n * onto the same volume through `--out` fails correctly, which is what gives it away.\n *\n * POSIX `write` returns a short count rather than an error when the disk fills partway\n * through a single call, and only the NEXT write raises ENOSPC. `--out` always has a next\n * write — channels.csv and metadata.json come after — so it always finds out. `--stdout`\n * has nothing after it, and when fd 1 is a regular file Node's stdout is a SyncWriteStream\n * whose `_write` discards the byte count `writeSync` returns, so nothing is raised at all.\n * No error means no `#failure`, so checking that alone would not have caught this.\n *\n * What can be checked is the descriptor: how much it grew against how much it was given.\n * Only for a regular file — a pipe, a terminal or a socket has no size to compare, and on\n * those a short write cannot go unreported this way. Appending (`>>`) is fine, since the\n * starting size is taken before anything is written.\n */\n/**\n * Exported so `--info` can use the same audit a `--stdout` conversion does.\n *\n * `--info` wrote its description with `process.stdout.write` and looked at nothing: redirected\n * into a full filesystem it produced a zero-byte file and exited 0, so `edf2csv rec.edf --info\n * > desc.txt` reported success over nothing at all. A 900-channel recording's description is\n * 58 KB, which is not a size a destination is guaranteed to have.\n */\nexport function auditStdout(): { count: (bytes: number) => void; verify: () => void } | null {\n  let startSize: number;\n  try {\n    const info = fstatSync(1);\n    if (!info.isFile()) return null;\n    startSize = info.size;\n  } catch {\n    // No usable descriptor to audit; the conversion is not the place to complain about it.\n    return null;\n  }\n\n  let expected = 0;\n  return {\n    count: (bytes: number): void => {\n      expected += bytes;\n    },\n    verify: (): void => {\n      let landed: number;\n      try {\n        landed = fstatSync(1).size - startSize;\n      } catch {\n        return;\n      }\n      if (landed >= expected) return;\n\n      /*\n        This audit exists for the failure nothing else reports: a write that is accepted, and\n        silently truncated. When the stream itself raised an error there is nothing left for\n        it to add, and what it added was a second `error:` line denying the first —\n\n          error: Writing to stdout failed: ENOSPC: no space left on device, write\n          error: Writing to stdout failed: 58900 of 58900 bytes did not reach the destination,\n                 which stopped accepting them part way through.\n                 ... nothing after it raised an error because there was nothing after it.\n\n        one failure, reported twice, the second of the two wrong about it.\n      */\n      if (process.stdout.errored) return;\n\n      /*\n        Nothing landing at all is not a short write, and was described as one.\n\n        `--info > desc.txt` onto a full filesystem left a zero-byte file, and this said the\n        destination \"stopped accepting them part way through\" and that \"what is there ends\n        mid-row\" — of a file with nothing in it and no rows in it.\n      */\n      if (landed === 0) {\n        throw new ConversionError(\n          'WRITE_FAILED',\n          `Writing to stdout failed: none of the ${expected} bytes reached the destination.`,\n          'The destination is almost certainly out of space. Nothing was written, so there ' +\n            'is nothing there to discard.',\n        );\n      }\n      throw new ConversionError(\n        'WRITE_FAILED',\n        `Writing to stdout failed: ${expected - landed} of ${expected} bytes did not reach ` +\n          `the destination, which stopped accepting them part way through.`,\n        'What is there ends mid-row and should not be used. The destination is almost ' +\n          'certainly out of space — a short write is how a filesystem reports filling up ' +\n          'mid-write, and nothing after it raised an error because there was nothing after it.',\n      );\n    },\n  };\n}\n\n/**\n * Why `--stdout` cannot take this recording, or null when it can.\n *\n * Lifted out of the conversion so `--info` can ask the same question. It was not asking:\n * `--info --stdout` on a three-rate recording predicted \"Would write 1,155 rows, roughly\n * 22.2 KB\" and said the channels \"are written to one file per rate\" — for a command that\n * refuses to run, writes nothing, and names no files. `--info` exists to say what a\n * conversion will do, and this is one of the things it does.\n *\n * Reported by `--info` as a warning rather than a refusal, for the reason 0.5.51 gives about\n * the destination guards: `--info` writes nothing, so a rule about what the output would be\n * has no business stopping it from describing the recording — and being told the command\n * will not work is exactly what you asked.\n */\nexport function stdoutRefusal(file: EdfFile, plan: ConversionPlan): ConversionError | null {\n  if (!plan.writeSignals) {\n    return new ConversionError(\n      'UNSUPPORTED_REQUEST',\n      '--stdout has no signal data to write because --annotations-only was given.',\n      'Drop one of the two flags.',\n    );\n  }\n\n    /*\n      No table at all is its own answer, and neither layout gave it.\n\n      A recording with no signal channels — one holding only EDF+ annotations — produced\n      zero rate groups. The wide layout then said \"--stdout needs exactly one table, but\n      this recording produces 0, one for each sampling rate its channels use ()\", with an\n      empty parenthetical, advice to narrow to one of no rates, and advice to use\n      `--layout long` — which wrote zero bytes to stdout, not even a header row, and exited\n      0 while warning that \"the signal files hold their headers and no data\". There were no\n      files and there was no header. The one path that was right about this is\n      `--annotations-only`, which refuses outright, and this is the same situation reached\n      by a different route.\n    */\n    if (plan.groups.length === 0) {\n      return new ConversionError(\n        'UNSUPPORTED_REQUEST',\n        file.dataSignals.length === 0\n          ? '--stdout has no signal data to write: this recording has no signal channels, ' +\n            'only EDF+ annotations.'\n          : '--stdout has no signal data to write: nothing was selected that carries samples.',\n        file.dataSignals.length === 0\n          ? 'Convert to a directory to get its annotations.csv, or drop --stdout.'\n          : 'Check --channels and the requested window, or convert to a directory instead.',\n      );\n    }\n\n    // The long layout is one table whatever the rates are, so it has nothing to refuse.\n    if (plan.layout !== 'long' && plan.groups.length !== 1) {\n      return new ConversionError(\n        'UNSUPPORTED_REQUEST',\n        // Naming the rates is the point: the hint says to narrow the selection, and this\n        // is what there is to narrow it to. The parenthetical used to repeat the count\n        // that had just been given — \"produces 3 (its channels use 3 different sampling\n        // rates)\" — which told nobody anything they could act on.\n        `--stdout needs exactly one table, but this recording produces ${plan.groups.length}, ` +\n          `one for each sampling rate its channels use ` +\n          `(${listed(formatRates(plan.groups.map((g) => g.rate)).map((r) => `${r} Hz`))}).`,\n        'Narrow it to one rate with --channels, write --layout long to get them all in ' +\n          'one table, or convert to a directory instead.',\n      );\n    }\n  return null;\n}\n\n\n\n/**\n * Asked for signal data and given none to put in a file.\n *\n * Every channel selected carries zero samples per record, so there is no table to make —\n * `edf2csv rec.edf --channels unused` writes channels.csv and metadata.json and no signals.csv\n * at all. The NO_SAMPLES warning explains the channel; nothing explained the missing file, and\n * the documentation says signals.csv is written unless --annotations-only was passed. Someone\n * looking for it should be told where it went.\n *\n * There are two ways to arrive with no groups, and one wording is only true of one of them. A\n * recording that holds nothing but EDF+ annotations has no channel that could have been\n * selected, its channels.csv is a header row and nothing else, and no channel of it carries\n * samples — so \"every channel selected\", \"channels.csv still describes them\" and \"which\n * channels do carry samples\" were three false statements in one warning, printed under a\n * warning that had just said the file has no signal channels.\n *\n * Exported, and worded in the present tense, so `--info` can raise the same one. It was built\n * inline here, which meant the one mode whose purpose is to say what a conversion will do said\n * nothing about the file that conversion would not write: `--info --strict` on a recording of\n * nothing but annotations reported one warning where converting it reported two, and\n * `--info --json` carried the shorter list to whatever reads it. Everything the answer depends\n * on is in the file and the plan, both of which `--info` already has.\n */\nexport function noSignalFile(file: EdfFile, plan: ConversionPlan): Diagnostic | null {\n  if (!plan.writeSignals || plan.groups.length > 0) return null;\n  const noChannelsAtAll = file.dataSignals.length === 0;\n  return {\n    code: 'NO_SAMPLES',\n    severity: 'warning',\n    message: noChannelsAtAll\n      ? 'No signal file is written: there is no signal data in this recording to put in one.'\n      : 'No signal file is written: every channel selected carries zero samples per data ' +\n        'record, so there is nothing to put in one.',\n    hint: noChannelsAtAll\n      ? 'annotations.csv holds whatever events it carries. channels.csv lists signal ' +\n        'channels, so it has none to list.'\n      : 'channels.csv still describes them. Run with --info to see which channels do carry ' +\n        'samples.',\n  };\n}\n\n/**\n * `--annotations-only` on a recording that has no annotations.\n *\n * Exported and present-tense for the same reason `noSignalFile` above is. `--info` prints an\n * accurate line about it in the report body — \"and no annotations.csv either, since this\n * recording has no annotation channel\" — and raised nothing, so the one mode whose purpose is\n * to say what a conversion will do carried a shorter warning list than the conversion did:\n * `--info --json --annotations-only` on a plain EDF file listed no warning where converting\n * lists one, and `--info --strict`, which cli-reference.md recommends for screening a folder\n * before converting it, exited 0 where the conversion exits 1. Same defect as the one 0.7.84\n * closed for `NO_SAMPLES`, one flag over; both halves of the answer are in the file and the\n * options, which `--info` already has.\n */\nexport function noAnnotations(file: EdfFile, options: ConvertOptions): Diagnostic | null {\n  if (options.annotationsOnly !== true || file.annotationSignals.length > 0) return null;\n  return {\n    code: 'NO_ANNOTATIONS',\n    severity: 'warning',\n    message:\n      '--annotations-only was requested but this recording has no annotation channel, ' +\n      'so there are no events to export.',\n    hint: 'Plain EDF files carry no annotations. Convert without --annotations-only to get the signals.',\n  };\n}\n\n/** Raised when the input moved while it was being read. See where it is pushed. */\nfunction inputChanged(hadChecksum: boolean): Diagnostic {\n  return {\n    code: 'INPUT_CHANGED',\n    severity: 'warning',\n    message:\n      'The input changed while it was being converted, so this output covers the file as ' +\n      'it was when the conversion started, not as it is now.',\n    hint: hadChecksum\n      ? 'No checksum was recorded: the bytes that were converted are no longer there to ' +\n        'hash. Convert again once the recording is finished.'\n      : 'Convert again once the recording is finished to pick up the rest.',\n  };\n}\n\nasync function writeMetadata(\n  outputDir: string,\n  inputPath: string,\n  file: EdfFile,\n  plan: ConversionPlan,\n  written: readonly WrittenFile[],\n  annotationCount: number,\n  /** Hash of the bytes that were converted, or null when it could not be vouched for. */\n  checksum: string | null,\n  /** Whether the record start times could be read; see withTimingPromiseKept. */\n  timedFromRecords: boolean,\n): Promise<void> {\n  const { header } = file;\n\n  /*\n    The file as it was when it was opened, not as it is now.\n\n    Both of these used to come from re-opening the path once the CSVs were written, which\n    describes whatever answers to that name by then rather than what was converted. A\n    recording still being written grew from 2,000 records to 3,000 mid-conversion and\n    metadata.json recorded `data_records: 2000` — correct, the CSV holds 2,000 — beside the\n    byte count and SHA-256 of the 3,000-record file. The two halves of one provenance record\n    described two different files, and the checksum covered bytes nobody had converted.\n    Replacing the file at that path did the same thing more thoroughly.\n\n    `file.fileSize` is the number every record count and window in this output was derived\n    from, and the hash is taken over exactly those bytes through the descriptor already open\n    on them, so the record describes one file throughout.\n  */\n  const metadata = {\n    tool: { name: 'edf2csv', version: TOOL_VERSION },\n    source: {\n      path: path.resolve(inputPath),\n      bytes: file.fileSize,\n      modified: new Date(file.modifiedAtOpenMs).toISOString(),\n      sha256: checksum,\n    },\n    recording: {\n      format: describeFormat(header),\n      version: header.version,\n      patient_id: header.patientId,\n      recording_id: header.recordingId,\n      // Zone-less on purpose: EDF records local wall-clock digits and no timezone.\n      start_datetime_local: formatWallClock(header.startDateTime),\n      start_date_raw: header.startDateRaw,\n      start_time_raw: header.startTimeRaw,\n      data_records: file.recordCount,\n      data_records_declared: header.declaredRecordCount,\n      record_duration_seconds: header.recordDuration,\n      duration_seconds: file.durationSeconds,\n      signal_count: header.signalCount,\n      annotation_channels: file.annotationSignals.length,\n    },\n    conversion: {\n      converted_at: new Date().toISOString(),\n      start_seconds: plan.range.startSeconds,\n      end_seconds: plan.range.endSeconds,\n      whole_recording: plan.range.isWholeRecording,\n      records_converted: [plan.range.startRecord, plan.range.endRecord],\n      annotations_written: annotationCount,\n      /*\n        Which shape the signal table is in, which nothing recorded.\n\n        A wide `signals.csv` and a long one are different files with different columns, and\n        metadata.json described them identically — so a pipeline handed an output directory\n        could not tell from the archive which it had. It matters most for `rate_groups` right\n        below: in the wide layout those entries are one per file and their `channels` are that\n        file's columns, and in the long layout every entry names the one shared table and its\n        `channels` are values in that table's `channel` column. Same array, two readings, and\n        no way to know which applied.\n      */\n      layout: plan.layout,\n      files: written.map((f) => ({ name: f.name, rows: f.rows })),\n      rate_groups: plan.groups.map((g) => ({\n        file: g.fileName,\n        sampling_rate_hz: g.rate,\n        channels: g.channels.map((c) => c.column),\n        decimals: g.channels.map((c) => c.decimals),\n      })),\n    },\n    notes: [\n      ...withTimingPromiseKept(withoutFileRateWarning(file.diagnostics), timedFromRecords),\n      ...plan.diagnostics,\n    ].map((d) => ({\n      code: d.code,\n      severity: d.severity,\n      message: d.message,\n    })),\n  };\n\n  await writeOutputFile(outputDir, 'metadata.json', JSON.stringify(metadata, null, 2) + '\\n');\n}\n\n\n"]}

package/dist/edf/header.js

@@ -783,8 +783,11 @@ export function parseHeader(buf, fileSize) {
         diagnostics.push({
             code: 'RECORD_COUNT_MISMATCH',
             severity: 'warning',
-            message: `The header declares ${declaredRecordCount} data records but the file contains ` +
-                `${recordCount}. Converting the ${counted(recordCount, 'record')} that ${recordCount === 1 ? 'is' : 'are'} present.`,
+            // Both counts through `counted`, not only the second. A header declaring one record
+            // over a file holding three read "declares 1 data records" — the slip the sentence
+            // beside it has been holding to since it was written.
+            message: `The header declares ${counted(declaredRecordCount, 'data record')} but the file ` +
+                `contains ${recordCount}. Converting the ${counted(recordCount, 'record')} that ${recordCount === 1 ? 'is' : 'are'} present.`,
             hint: declaredRecordCount > recordCount
                 ? 'The recording looks truncated. It may have been cut short or copied incompletely.'
                 : 'The file is longer than its header claims.',

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 { plain } from '../format/number.js';\n// The shell-quoting rule for a label, shared rather than repeated: this hint and\n// `--channels`' own \"did you mean\" have to print the same command for the same label.\nimport { typeable } from '../convert/channels.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 * Whether a spreadsheet reads this field as the start of a formula rather than as text.\n *\n * `=` and `@` unconditionally; every list of these characters names two more, and this had\n * `-` as an exception with the reason written out on the warnings page: \"a lone `-` is a\n * real convention for no unit ... and neither is evaluated unless what follows it parses as a\n * formula\". Which is the condition, and it was not being applied — nothing with a leading\n * minus was flagged at all. A channel labelled `-2+3` opens as a column headed `1`, and\n * `-HYPERLINK(\"http://...\",\"EEG\")` is a name the spreadsheet resolves, in silence.\n *\n * So the exception is what it says it is rather than the whole character. A lone `-` is left\n * as text by every spreadsheet and is not flagged; a field that is entirely a number reads as\n * that number, which is what the header says, and is not flagged either. Anything else after\n * the minus is arithmetic or a name.\n *\n * And `+` takes the same exception, which it did not. It is the same rule in the spreadsheet —\n * Lotus compatibility, which converts a leading `+` or `-` to a formula when what follows one\n * parses as a formula and leaves it as text when it does not — so the two signs cannot differ\n * here for a reason that comes from the sign. A channel labelled `+100` was warned about as\n * something a spreadsheet \"reads as the start of a formula rather than as text\", over a cell\n * that opens as 100, which is what the header says; `-100` beside it said nothing, and under\n * `--strict` the difference was an exit code. `+1+1` is still arithmetic and still flagged.\n */\nfunction startsFormula(text: string): boolean {\n  if (/^[=@]/u.test(text)) return true;\n  if (!/^[+-]./u.test(text)) return false;\n  return !/^[+-](?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:[eE][+-]?\\d+)?$/u.test(text);\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 text = normaliseNumberField(dec(fixed, 252, 4)).text;\n  if (!DECIMAL_FIELD.test(text)) return null;\n  const count = Number(text);\n  return Number.isInteger(count) && count > 0 ? count : null;\n}\n\n/**\n * What EDF allows a numeric field to look like, which is less than `Number()` allows.\n *\n * A sign, digits, an optional fractional part, an optional exponent — the spec's own grammar,\n * plus the exponent form the 8-character physical bounds need to reach a magnetometer's range\n * and which real headers use.\n *\n * `Number()` accepts a great deal more, and every one of those forms is a header this tool\n * would have read as a number nobody wrote. A physical maximum of `0x64` came out as 100: it\n * printed as `-100 to 100` in the channel table, went into channels.csv as `physical_max,100`,\n * and set the gain every sample on that channel was scaled by — a whole calibration invented\n * from four bytes that are not a decimal number, exit 0, no diagnostic. `0b1100100` and `0o144`\n * are the same hundred, and `0x02` in the signal-count field is a two-channel recording.\n *\n * The same mistake as `#0x2` reaching channel 2 through `--channels`, `--decimals 0o5` writing\n * five places and `--jobs 0x10` running sixteen, all of which have their own comments and their\n * own fixes. Those were values somebody typed. These are the fields every number in the output\n * is computed from, and the page describing them says \"all fields are ASCII\" and gives the\n * layout digit by digit.\n */\nconst DECIMAL_FIELD = /^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?$/u;\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 = DECIMAL_FIELD.test(text) ? Number(text) : NaN;\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/** Whether the start time names the sixtieth second. See LEAP_SECOND_START. */\nfunction namesLeapSecond(timeRaw: string): boolean {\n  const t = /^(\\d{2})[.:\\-](\\d{2})[.:\\-](\\d{2})$/u.exec(trimField(timeRaw));\n  return t !== null && Number(t[3]) === 60;\n}\n\nconst MONTHS = ['JAN', 'FEB', 'MAR', 'APR', 'MAY', 'JUN', 'JUL', 'AUG', 'SEP', 'OCT', 'NOV', 'DEC'];\n\n/**\n * The date an EDF+ recording ID states, which is the only place the file writes a full year.\n *\n * EDF+ requires the recording identification field to begin `Startdate dd-MMM-yyyy`, and\n * requires it to agree with the header's own date field. It is a four-digit year, so it says\n * something the eight-character date field physically cannot.\n */\nfunction recordingIdStartdate(\n  recordingId: string,\n): { day: number; month: number; year: number } | null {\n  const stated = /^Startdate\\s+(\\d{2})-([A-Za-z]{3})-(\\d{4})(?:\\s|$)/u.exec(recordingId.trim());\n  if (!stated) return null;\n  const month = MONTHS.indexOf((stated[2] as string).toUpperCase()) + 1;\n  if (month === 0) return null;\n  return { day: Number(stated[1]), month, year: Number(stated[3]) };\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 *\n * Which is why EDF+ writes it again in full, in the recording identification field, and why\n * that is used here when it is there. The rule alone reports a recording made in 1984 as 2084\n * and one made in 2085 as 1985 — a hundred years out, on a file that states the year plainly\n * four fields earlier. Taken only where the two agree about everything the header can express:\n * the same day, the same month, and a four-digit year ending in the two digits the header\n * wrote. A recording ID that contradicts the header is a different problem and is left to the\n * spec's rule, which is at least the one the format defines.\n */\nfunction resolveStartDateTime(\n  dateRaw: string,\n  timeRaw: string,\n  recordingId = '',\n): 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 stated = recordingIdStartdate(recordingId);\n  const year =\n    stated !== null && stated.day === dd && stated.month === mm && stated.year % 100 === yy\n      ? stated.year\n      : yy >= 85\n        ? 1900 + yy\n        : 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 ${counted(fileSize, 'byte')}; 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 ${plain(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 ${counted(signalCount, 'signal')}, 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 ${counted(signalCount, 'signal')} ` +\n        `${signalCount === 1 ? 'requires' : 'require'} ${expectedHeaderBytes} bytes. ` +\n        `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 ${control.length === 1 ? 'it' : '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              A comma is the third way. `--channels` separates names with one, and splits on\n              every occurrence, so a channel labelled `EEG Fpz-Cz, ref` cannot be selected by\n              name at all: the quoted-back advice printed `--channels \"EEG Fpz-Cz, ref\"`, which\n              exits 2 with `No channel named \"EEG Fpz-Cz\"` — a channel the file does not have,\n              named after half of one it does. Commas in labels are ordinary, since EDF labels\n              are free text, and the CSV header quotes them; only this one hint claimed\n              something about them that isn't so.\n            */\n            /*\n              And a fourth way, which this branch printed straight past.\n\n              A shell expands `$`, a backtick and a backslash inside double quotes, so a\n              channel labelled `EEG $ref` was answered with `--channels \"EEG $ref\"` — which\n              arrives as `EEG ` and exits 2 on a channel the file does not have. A backtick\n              opens a command substitution and the pasted line does not even finish. That is\n              the failure 0.7.18 fixed for `--channels`' own suggestion, and `typeable` is the\n              rule it fixed it with: double quotes where they survive, single quotes where\n              they do not, null where nothing does. Asking it settles which branch this takes\n              as well, so the two cannot disagree about one label again.\n            */\n            (typeable(label) === null\n              ? `Address the channel by position with --channels \"#${i}\" rather than by name, ` +\n                `since ${\n                  inLabel\n                    ? 'the name cannot be typed'\n                    : label === ''\n                      ? 'it has no label'\n                      : 'a comma in the label would read as two names'\n                }. `\n              : `The column name is unaffected, so --channels ${typeable(label) as string} still selects it. `) +\n            'Printing the CSV to a terminal may do more than print it.',\n        });\n      }\n\n      /*\n        Header text a spreadsheet will run rather than read.\n\n        The same four free-text fields, asked a different question. `=`, `+` and `@` start a\n        formula in Excel, LibreOffice and Sheets no matter which file the cell came from, and\n        these fields land in a CSV header row and in channels.csv verbatim — so a channel\n        labelled `=1+1` opens as a column headed 2, and `=HYPERLINK(...)` opens as a link\n        nobody in the reading chain wrote. SECURITY.md already calls these fields\n        attacker-controlled because they reach filenames; this is where they reach a program\n        that executes text.\n\n        Not `-`, which the same advice usually includes. A lone `-` is a real convention for\n        \"no unit\" and appears in the fixtures, a leading `-` on a montage label is ordinary,\n        and neither is executed unless what follows parses as a formula — so warning on it\n        would fire on files that are fine, which is how a warning gets ignored.\n\n        Said, not fixed. Prefixing the cell with a quote is the usual mitigation and would mean\n        writing something the header does not say, which is the one thing this tool refuses to\n        do; NONPRINTABLE_LABEL answers control bytes the same way.\n      */\n      const formulaic = fields.filter(([, text]) => startsFormula(text));\n      if (formulaic.length > 0) {\n        const names = formulaic.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        const shown = [...new Set(formulaic.map(([, text]) => text[0] as string))].join(', ');\n        diagnostics.push({\n          code: 'FORMULA_LABEL',\n          severity: 'warning',\n          message:\n            `Signal ${i}'s ${named} ${formulaic.length === 1 ? 'starts' : 'start'} with ` +\n            `${shown}, which Excel, LibreOffice and Google Sheets read as the start of a ` +\n            `formula rather than as text.`,\n          hint:\n            'The text is written exactly as the header has it, so the cell is what the ' +\n            'recording says. Open the CSV with pandas or R, or import it into the ' +\n            'spreadsheet as text, if you do not want it evaluated.',\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  /*\n    The sixtieth second, which is a second UTC has and a calendar date does not.\n\n    `resolveStartDateTime` admits `ss === 60` on purpose — a recorder synchronised to UTC\n    through a leap second writes `23.59.60`, and refusing it would throw away a date that is\n    otherwise perfectly good over one second. What it then does is `Math.min(ss, 59)`, because\n    `Date.UTC(..., 60)` rolls over into the next minute and would move the instant the other\n    way, by fifty-nine seconds more.\n\n    Keeping the nearest instant is the right answer. Keeping it in silence was not: `--info`\n    printed `Recorded 2020-01-01 23:59:59` and metadata.json recorded the same, for a header\n    that says `23.59.60`, with `--strict` exiting 0. Every other header field this tool cannot\n    represent exactly says so — a comma decimal separator, a physical span that overflows, a\n    record count that disagrees with the file — and this is the field `time_s` is documented as\n    being added to.\n  */\n  if (\n    namesLeapSecond(startTimeRaw) &&\n    resolveStartDateTime(startDateRaw, startTimeRaw, recordingId) !== null\n  ) {\n    diagnostics.push({\n      code: 'LEAP_SECOND_START',\n      severity: 'warning',\n      message:\n        `The header's start time (\"${startTimeRaw}\") names the sixtieth second of a minute, ` +\n        `which no calendar date has.`,\n      hint:\n        'It is recorded as the fifty-ninth second, one second earlier, since that is the ' +\n        'nearest instant a date can hold. time_s is unaffected — it counts from the start of ' +\n        'the recording either way.',\n    });\n  }\n\n  /*\n    Two dates in one header, disagreeing.\n\n    EDF+ requires the recording identification field's `Startdate` to be the header's start\n    date. Where it is, its four digits settle the century — see resolveStartDateTime. Where it\n    is not, one of the two is wrong and there is no way to tell which, so the date field is\n    used, being the one the format defines. That was done in silence, on a header that plainly\n    contradicts itself:\n\n        Recorded   2002-03-02 22:15:00\n        Recording  Startdate 05-MAR-2002 PSG-1234/2002 NN Telemetry03\n\n    The same shape as a record count that disagrees with the file, or a declared header size\n    that disagrees with the signal count, both of which have said so for versions.\n  */\n  const statedDate = recordingIdStartdate(recordingId);\n  const headerDate = /^(\\d{2})[.\\-/](\\d{2})[.\\-/](\\d{2})$/u.exec(trimField(startDateRaw));\n  if (statedDate !== null && headerDate !== null) {\n    const day = Number(headerDate[1]);\n    const month = Number(headerDate[2]);\n    const yy = Number(headerDate[3]);\n    if (statedDate.day !== day || statedDate.month !== month || statedDate.year % 100 !== yy) {\n      diagnostics.push({\n        code: 'START_DATE_MISMATCH',\n        severity: 'warning',\n        message:\n          `The header's start date (\"${startDateRaw}\") and the date its recording ` +\n          `identification states (\"${String(statedDate.day).padStart(2, '0')}-` +\n          `${MONTHS[statedDate.month - 1] as string}-${statedDate.year}\") are different ` +\n          `dates, which EDF+ does not permit.`,\n        hint:\n          'The start date field is used, since that is the one the format defines. Which of ' +\n          'the two is right is not knowable from the file, so start_datetime_local may name ' +\n          'the wrong day.',\n      });\n    }\n  }\n\n  if (resolveStartDateTime(startDateRaw, startTimeRaw, recordingId) === 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      /*\n        Cut by the function that cuts every other list in a sentence here.\n\n        `join` names all of them, however many there are, and a header may declare as many\n        channels as it likes under one label: a 200-channel montage all labelled `T8-P8` — which\n        is exactly the kind of file this warning is for, since CHB-MIT ships two of them —\n        produced a single 1,100-character line of positions with the sentence that mattered at\n        the front of it. `listed` shows eight and counts the rest, which is what the rate\n        warning, the leftover-file warning, the channel-position lists in `--channels` and the\n        `EMPTY_LABEL` message one loop up all already do. This was the last `join` of a\n        file-controlled list left in a diagnostic.\n\n        Two positions render identically either way, so the ordinary duplicate reads as it\n        always has.\n      */\n      /*\n        Positions written `#N`, which is how a position is written everywhere it is meant to be\n        typed: `--channels \"#0\"`, \"This file has signal channels at #0, #1, #2\", and this\n        warning's own namesake from channel selection — \"(positions #0, #1); all of them were\n        selected\". This one said \"(positions 0, 1)\", two paragraphs above the page that tells\n        the reader to \"address it by position with #N\". The number is the same; the form that\n        works is not.\n      */\n      message: `${indices.length} signals share the label \"${label}\" (positions ${listed(indices.map((i) => `#${i}`))}).`,\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, recordingId),\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/**\n * The recording's format, as `--info`, `metadata.json` and `--json` all name it.\n *\n * `\"EDF\"`, `\"BDF\"`, or one of `\"EDF+ (continuous)\"`, `\"EDF+ (discontinuous)\"`,\n * `\"BDF+ (continuous)\"`, `\"BDF+ (discontinuous)\"`. A BDF+ file reports its own spelling even\n * though `continuity` normalises the marker to the `EDF+` form.\n *\n * This said `EDF+ (EDF+D)` and `BDF+ (EDF+C)`, which are not strings it can return — the\n * parenthetical is the word, not the marker. It is a one-line doc comment on a public export,\n * so it is what a TypeScript consumer's editor shows and what `dist/edf/header.d.ts` ships,\n * and the value it describes is `recording.format` in every metadata.json this tool writes.\n * A consumer branching on the tooltip's spelling never matches. Every documentation page had\n * it right; this was the only place that did not.\n */\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)) {\n    /*\n      The same six decimals, in the notation `toFixed` cannot reach.\n\n      Every double past 2^53 is an integer, so this branch takes every large rate — and\n      `String` switches to exponent form at 1e21 and carries the full seventeen digits with\n      it. Four samples in a record of 1e-300s is 3.9999999999999996e+300, which is exactly the\n      float noise the rounding below exists to remove, printed in a `RATE` column of otherwise\n      plain numbers and pasted into an output filename by `rateSlug`. Below 1e21 `String` is\n      already exact and is left alone, so an integer rate a file can really state — 2^53\n      samples in a second — is not rounded to something it is not.\n    */\n    const text = String(hz);\n    return text.includes('e') ? String(Number(hz.toExponential(6))) : text;\n  }\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 { plain } from '../format/number.js';\n// The shell-quoting rule for a label, shared rather than repeated: this hint and\n// `--channels`' own \"did you mean\" have to print the same command for the same label.\nimport { typeable } from '../convert/channels.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 * Whether a spreadsheet reads this field as the start of a formula rather than as text.\n *\n * `=` and `@` unconditionally; every list of these characters names two more, and this had\n * `-` as an exception with the reason written out on the warnings page: \"a lone `-` is a\n * real convention for no unit ... and neither is evaluated unless what follows it parses as a\n * formula\". Which is the condition, and it was not being applied — nothing with a leading\n * minus was flagged at all. A channel labelled `-2+3` opens as a column headed `1`, and\n * `-HYPERLINK(\"http://...\",\"EEG\")` is a name the spreadsheet resolves, in silence.\n *\n * So the exception is what it says it is rather than the whole character. A lone `-` is left\n * as text by every spreadsheet and is not flagged; a field that is entirely a number reads as\n * that number, which is what the header says, and is not flagged either. Anything else after\n * the minus is arithmetic or a name.\n *\n * And `+` takes the same exception, which it did not. It is the same rule in the spreadsheet —\n * Lotus compatibility, which converts a leading `+` or `-` to a formula when what follows one\n * parses as a formula and leaves it as text when it does not — so the two signs cannot differ\n * here for a reason that comes from the sign. A channel labelled `+100` was warned about as\n * something a spreadsheet \"reads as the start of a formula rather than as text\", over a cell\n * that opens as 100, which is what the header says; `-100` beside it said nothing, and under\n * `--strict` the difference was an exit code. `+1+1` is still arithmetic and still flagged.\n */\nfunction startsFormula(text: string): boolean {\n  if (/^[=@]/u.test(text)) return true;\n  if (!/^[+-]./u.test(text)) return false;\n  return !/^[+-](?:\\d+(?:\\.\\d+)?|\\.\\d+)(?:[eE][+-]?\\d+)?$/u.test(text);\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 text = normaliseNumberField(dec(fixed, 252, 4)).text;\n  if (!DECIMAL_FIELD.test(text)) return null;\n  const count = Number(text);\n  return Number.isInteger(count) && count > 0 ? count : null;\n}\n\n/**\n * What EDF allows a numeric field to look like, which is less than `Number()` allows.\n *\n * A sign, digits, an optional fractional part, an optional exponent — the spec's own grammar,\n * plus the exponent form the 8-character physical bounds need to reach a magnetometer's range\n * and which real headers use.\n *\n * `Number()` accepts a great deal more, and every one of those forms is a header this tool\n * would have read as a number nobody wrote. A physical maximum of `0x64` came out as 100: it\n * printed as `-100 to 100` in the channel table, went into channels.csv as `physical_max,100`,\n * and set the gain every sample on that channel was scaled by — a whole calibration invented\n * from four bytes that are not a decimal number, exit 0, no diagnostic. `0b1100100` and `0o144`\n * are the same hundred, and `0x02` in the signal-count field is a two-channel recording.\n *\n * The same mistake as `#0x2` reaching channel 2 through `--channels`, `--decimals 0o5` writing\n * five places and `--jobs 0x10` running sixteen, all of which have their own comments and their\n * own fixes. Those were values somebody typed. These are the fields every number in the output\n * is computed from, and the page describing them says \"all fields are ASCII\" and gives the\n * layout digit by digit.\n */\nconst DECIMAL_FIELD = /^[+-]?(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:[eE][+-]?\\d+)?$/u;\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 = DECIMAL_FIELD.test(text) ? Number(text) : NaN;\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/** Whether the start time names the sixtieth second. See LEAP_SECOND_START. */\nfunction namesLeapSecond(timeRaw: string): boolean {\n  const t = /^(\\d{2})[.:\\-](\\d{2})[.:\\-](\\d{2})$/u.exec(trimField(timeRaw));\n  return t !== null && Number(t[3]) === 60;\n}\n\nconst MONTHS = ['JAN', 'FEB', 'MAR', 'APR', 'MAY', 'JUN', 'JUL', 'AUG', 'SEP', 'OCT', 'NOV', 'DEC'];\n\n/**\n * The date an EDF+ recording ID states, which is the only place the file writes a full year.\n *\n * EDF+ requires the recording identification field to begin `Startdate dd-MMM-yyyy`, and\n * requires it to agree with the header's own date field. It is a four-digit year, so it says\n * something the eight-character date field physically cannot.\n */\nfunction recordingIdStartdate(\n  recordingId: string,\n): { day: number; month: number; year: number } | null {\n  const stated = /^Startdate\\s+(\\d{2})-([A-Za-z]{3})-(\\d{4})(?:\\s|$)/u.exec(recordingId.trim());\n  if (!stated) return null;\n  const month = MONTHS.indexOf((stated[2] as string).toUpperCase()) + 1;\n  if (month === 0) return null;\n  return { day: Number(stated[1]), month, year: Number(stated[3]) };\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 *\n * Which is why EDF+ writes it again in full, in the recording identification field, and why\n * that is used here when it is there. The rule alone reports a recording made in 1984 as 2084\n * and one made in 2085 as 1985 — a hundred years out, on a file that states the year plainly\n * four fields earlier. Taken only where the two agree about everything the header can express:\n * the same day, the same month, and a four-digit year ending in the two digits the header\n * wrote. A recording ID that contradicts the header is a different problem and is left to the\n * spec's rule, which is at least the one the format defines.\n */\nfunction resolveStartDateTime(\n  dateRaw: string,\n  timeRaw: string,\n  recordingId = '',\n): 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 stated = recordingIdStartdate(recordingId);\n  const year =\n    stated !== null && stated.day === dd && stated.month === mm && stated.year % 100 === yy\n      ? stated.year\n      : yy >= 85\n        ? 1900 + yy\n        : 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 ${counted(fileSize, 'byte')}; 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 ${plain(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 ${counted(signalCount, 'signal')}, 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 ${counted(signalCount, 'signal')} ` +\n        `${signalCount === 1 ? 'requires' : 'require'} ${expectedHeaderBytes} bytes. ` +\n        `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 ${control.length === 1 ? 'it' : '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              A comma is the third way. `--channels` separates names with one, and splits on\n              every occurrence, so a channel labelled `EEG Fpz-Cz, ref` cannot be selected by\n              name at all: the quoted-back advice printed `--channels \"EEG Fpz-Cz, ref\"`, which\n              exits 2 with `No channel named \"EEG Fpz-Cz\"` — a channel the file does not have,\n              named after half of one it does. Commas in labels are ordinary, since EDF labels\n              are free text, and the CSV header quotes them; only this one hint claimed\n              something about them that isn't so.\n            */\n            /*\n              And a fourth way, which this branch printed straight past.\n\n              A shell expands `$`, a backtick and a backslash inside double quotes, so a\n              channel labelled `EEG $ref` was answered with `--channels \"EEG $ref\"` — which\n              arrives as `EEG ` and exits 2 on a channel the file does not have. A backtick\n              opens a command substitution and the pasted line does not even finish. That is\n              the failure 0.7.18 fixed for `--channels`' own suggestion, and `typeable` is the\n              rule it fixed it with: double quotes where they survive, single quotes where\n              they do not, null where nothing does. Asking it settles which branch this takes\n              as well, so the two cannot disagree about one label again.\n            */\n            (typeable(label) === null\n              ? `Address the channel by position with --channels \"#${i}\" rather than by name, ` +\n                `since ${\n                  inLabel\n                    ? 'the name cannot be typed'\n                    : label === ''\n                      ? 'it has no label'\n                      : 'a comma in the label would read as two names'\n                }. `\n              : `The column name is unaffected, so --channels ${typeable(label) as string} still selects it. `) +\n            'Printing the CSV to a terminal may do more than print it.',\n        });\n      }\n\n      /*\n        Header text a spreadsheet will run rather than read.\n\n        The same four free-text fields, asked a different question. `=`, `+` and `@` start a\n        formula in Excel, LibreOffice and Sheets no matter which file the cell came from, and\n        these fields land in a CSV header row and in channels.csv verbatim — so a channel\n        labelled `=1+1` opens as a column headed 2, and `=HYPERLINK(...)` opens as a link\n        nobody in the reading chain wrote. SECURITY.md already calls these fields\n        attacker-controlled because they reach filenames; this is where they reach a program\n        that executes text.\n\n        Not `-`, which the same advice usually includes. A lone `-` is a real convention for\n        \"no unit\" and appears in the fixtures, a leading `-` on a montage label is ordinary,\n        and neither is executed unless what follows parses as a formula — so warning on it\n        would fire on files that are fine, which is how a warning gets ignored.\n\n        Said, not fixed. Prefixing the cell with a quote is the usual mitigation and would mean\n        writing something the header does not say, which is the one thing this tool refuses to\n        do; NONPRINTABLE_LABEL answers control bytes the same way.\n      */\n      const formulaic = fields.filter(([, text]) => startsFormula(text));\n      if (formulaic.length > 0) {\n        const names = formulaic.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        const shown = [...new Set(formulaic.map(([, text]) => text[0] as string))].join(', ');\n        diagnostics.push({\n          code: 'FORMULA_LABEL',\n          severity: 'warning',\n          message:\n            `Signal ${i}'s ${named} ${formulaic.length === 1 ? 'starts' : 'start'} with ` +\n            `${shown}, which Excel, LibreOffice and Google Sheets read as the start of a ` +\n            `formula rather than as text.`,\n          hint:\n            'The text is written exactly as the header has it, so the cell is what the ' +\n            'recording says. Open the CSV with pandas or R, or import it into the ' +\n            'spreadsheet as text, if you do not want it evaluated.',\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  /*\n    The sixtieth second, which is a second UTC has and a calendar date does not.\n\n    `resolveStartDateTime` admits `ss === 60` on purpose — a recorder synchronised to UTC\n    through a leap second writes `23.59.60`, and refusing it would throw away a date that is\n    otherwise perfectly good over one second. What it then does is `Math.min(ss, 59)`, because\n    `Date.UTC(..., 60)` rolls over into the next minute and would move the instant the other\n    way, by fifty-nine seconds more.\n\n    Keeping the nearest instant is the right answer. Keeping it in silence was not: `--info`\n    printed `Recorded 2020-01-01 23:59:59` and metadata.json recorded the same, for a header\n    that says `23.59.60`, with `--strict` exiting 0. Every other header field this tool cannot\n    represent exactly says so — a comma decimal separator, a physical span that overflows, a\n    record count that disagrees with the file — and this is the field `time_s` is documented as\n    being added to.\n  */\n  if (\n    namesLeapSecond(startTimeRaw) &&\n    resolveStartDateTime(startDateRaw, startTimeRaw, recordingId) !== null\n  ) {\n    diagnostics.push({\n      code: 'LEAP_SECOND_START',\n      severity: 'warning',\n      message:\n        `The header's start time (\"${startTimeRaw}\") names the sixtieth second of a minute, ` +\n        `which no calendar date has.`,\n      hint:\n        'It is recorded as the fifty-ninth second, one second earlier, since that is the ' +\n        'nearest instant a date can hold. time_s is unaffected — it counts from the start of ' +\n        'the recording either way.',\n    });\n  }\n\n  /*\n    Two dates in one header, disagreeing.\n\n    EDF+ requires the recording identification field's `Startdate` to be the header's start\n    date. Where it is, its four digits settle the century — see resolveStartDateTime. Where it\n    is not, one of the two is wrong and there is no way to tell which, so the date field is\n    used, being the one the format defines. That was done in silence, on a header that plainly\n    contradicts itself:\n\n        Recorded   2002-03-02 22:15:00\n        Recording  Startdate 05-MAR-2002 PSG-1234/2002 NN Telemetry03\n\n    The same shape as a record count that disagrees with the file, or a declared header size\n    that disagrees with the signal count, both of which have said so for versions.\n  */\n  const statedDate = recordingIdStartdate(recordingId);\n  const headerDate = /^(\\d{2})[.\\-/](\\d{2})[.\\-/](\\d{2})$/u.exec(trimField(startDateRaw));\n  if (statedDate !== null && headerDate !== null) {\n    const day = Number(headerDate[1]);\n    const month = Number(headerDate[2]);\n    const yy = Number(headerDate[3]);\n    if (statedDate.day !== day || statedDate.month !== month || statedDate.year % 100 !== yy) {\n      diagnostics.push({\n        code: 'START_DATE_MISMATCH',\n        severity: 'warning',\n        message:\n          `The header's start date (\"${startDateRaw}\") and the date its recording ` +\n          `identification states (\"${String(statedDate.day).padStart(2, '0')}-` +\n          `${MONTHS[statedDate.month - 1] as string}-${statedDate.year}\") are different ` +\n          `dates, which EDF+ does not permit.`,\n        hint:\n          'The start date field is used, since that is the one the format defines. Which of ' +\n          'the two is right is not knowable from the file, so start_datetime_local may name ' +\n          'the wrong day.',\n      });\n    }\n  }\n\n  if (resolveStartDateTime(startDateRaw, startTimeRaw, recordingId) === 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      /*\n        Cut by the function that cuts every other list in a sentence here.\n\n        `join` names all of them, however many there are, and a header may declare as many\n        channels as it likes under one label: a 200-channel montage all labelled `T8-P8` — which\n        is exactly the kind of file this warning is for, since CHB-MIT ships two of them —\n        produced a single 1,100-character line of positions with the sentence that mattered at\n        the front of it. `listed` shows eight and counts the rest, which is what the rate\n        warning, the leftover-file warning, the channel-position lists in `--channels` and the\n        `EMPTY_LABEL` message one loop up all already do. This was the last `join` of a\n        file-controlled list left in a diagnostic.\n\n        Two positions render identically either way, so the ordinary duplicate reads as it\n        always has.\n      */\n      /*\n        Positions written `#N`, which is how a position is written everywhere it is meant to be\n        typed: `--channels \"#0\"`, \"This file has signal channels at #0, #1, #2\", and this\n        warning's own namesake from channel selection — \"(positions #0, #1); all of them were\n        selected\". This one said \"(positions 0, 1)\", two paragraphs above the page that tells\n        the reader to \"address it by position with #N\". The number is the same; the form that\n        works is not.\n      */\n      message: `${indices.length} signals share the label \"${label}\" (positions ${listed(indices.map((i) => `#${i}`))}).`,\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      // Both counts through `counted`, not only the second. A header declaring one record\n      // over a file holding three read \"declares 1 data records\" — the slip the sentence\n      // beside it has been holding to since it was written.\n      message:\n        `The header declares ${counted(declaredRecordCount, 'data record')} but the file ` +\n        `contains ${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, recordingId),\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/**\n * The recording's format, as `--info`, `metadata.json` and `--json` all name it.\n *\n * `\"EDF\"`, `\"BDF\"`, or one of `\"EDF+ (continuous)\"`, `\"EDF+ (discontinuous)\"`,\n * `\"BDF+ (continuous)\"`, `\"BDF+ (discontinuous)\"`. A BDF+ file reports its own spelling even\n * though `continuity` normalises the marker to the `EDF+` form.\n *\n * This said `EDF+ (EDF+D)` and `BDF+ (EDF+C)`, which are not strings it can return — the\n * parenthetical is the word, not the marker. It is a one-line doc comment on a public export,\n * so it is what a TypeScript consumer's editor shows and what `dist/edf/header.d.ts` ships,\n * and the value it describes is `recording.format` in every metadata.json this tool writes.\n * A consumer branching on the tooltip's spelling never matches. Every documentation page had\n * it right; this was the only place that did not.\n */\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)) {\n    /*\n      The same six decimals, in the notation `toFixed` cannot reach.\n\n      Every double past 2^53 is an integer, so this branch takes every large rate — and\n      `String` switches to exponent form at 1e21 and carries the full seventeen digits with\n      it. Four samples in a record of 1e-300s is 3.9999999999999996e+300, which is exactly the\n      float noise the rounding below exists to remove, printed in a `RATE` column of otherwise\n      plain numbers and pasted into an output filename by `rateSlug`. Below 1e21 `String` is\n      already exact and is left alone, so an integer rate a file can really state — 2^53\n      samples in a second — is not rounded to something it is not.\n    */\n    const text = String(hz);\n    return text.includes('e') ? String(Number(hz.toExponential(6))) : text;\n  }\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.7.210",
+  "version": "0.7.212",
   "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",