edf2csv 0.9.11 → 0.9.13

package/dist/cli/report.js

@@ -708,10 +708,28 @@ export function elapsed(milliseconds) {
       to the tenth this already prints first, because `formatDuration` keeps three decimals and
       "6m 52.734s" claims a precision two `Date.now()` readings do not have.
     */
-    if (milliseconds >= 60_000)
-        return formatDuration(Math.round(milliseconds / 100) / 10);
+    /*
+      Rounded to the precision that will be printed, and only then given a form.
+  
+      The branch was chosen at sixty thousand milliseconds and the seconds were rounded to one
+      decimal afterwards, so the last fifty milliseconds below the handover rounded up through
+      it: 59,950 to 59,999 printed `60.0s`, a minute stated in seconds, one millisecond under
+      the line that exists so a minute is stated as a minute.
+  
+          Done in 60.0s.        59,999 ms
+          Done in 1m 0s.        60,000 ms
+  
+      Which is the slip `formatBytes` fixed in the same words — "Rounding can carry into the
+      next unit, and the unit was chosen before it: 1,048,575 bytes is 1023.999 KB, which
+      printed as 1024 KB" — and the one the paragraph above cites as the rule this function
+      follows. Rounding first is what `formatDuration` does before it splits into hours and
+      minutes, for the same reason.
+    */
+    const tenths = Math.round(milliseconds / 100) / 10;
+    if (tenths >= 60)
+        return formatDuration(tenths);
     if (milliseconds >= 50)
-        return `${(milliseconds / 1000).toFixed(1)}s`;
+        return `${tenths.toFixed(1)}s`;
     return milliseconds > 0 ? `${milliseconds}ms` : 'under 1ms';
 }
 /**

package/dist/cli/report.js.map

@@ -1 +1 @@
-{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Human-readable output for the terminal.\n *\n * Everything here is plain text with no colour codes, so piping to a file or a log\n * produces exactly what appeared on screen.\n */\n\nimport type { Diagnostic } from '../edf/errors.js';\nimport type { EdfFile } from '../edf/reader.js';\nimport { describeFormat, formatRates, formatWallClock } from '../edf/header.js';\nimport { fixed, formatBytes, formatDuration, plainSeconds } from '../format/number.js';\nimport { counted, grouped } from '../format/list.js';\nimport { escapeJsonText, printable } from '../format/unprintable.js';\nimport type { ConversionPlan } from '../convert/plan.js';\nimport { withoutFileRateWarning } from '../convert/plan.js';\nimport type { ConvertResult } from '../convert/run.js';\nimport { VERSION } from '../version.js';\n\n/** Where terminal prose wraps. The width --help is written to, and the ANSI default. */\nconst WRAP_COLUMNS = 80;\n\n/** The continuation indent under a `warning: ` prefix, which is the only one there is. */\nconst HINT_INDENT = ' '.repeat(9);\n\n/**\n * One unbreakable unit of a wrapped line: a quoted span, or a run of non-space.\n *\n * The lookbehind is what keeps an apostrophe out of it. `the file's own header and it's` has\n * two of them, and without the guard `'s own header and it'` is one quoted span — a token\n * with spaces in it that then refuses to break. A quote opening a span is at the start of a\n * word, so that is what is required of it.\n */\nconst WORD = /(?<=^|[\\s(])(?:\"[^\"]*\"|'[^']*')|\\S+/gu;\n\n/**\n * Greedy word wrap, `indent` on every line including the first.\n *\n * Only free prose goes through this. The aligned parts of `--info` — the `Format`/`Size`\n * key-value lines and the channel table — are laid out in columns, and re-flowing a column\n * is how you turn a table into a paragraph.\n *\n * A word wider than the column is left to overrun rather than broken. The long words here\n * are file paths and quoted channel labels, and neither survives being split across lines:\n * the point of printing a path is that it can be copied back out.\n *\n * A quoted span is one word for the same reason, however many spaces are inside it. The\n * sentence above is the promise, and it held only for the paths that have no spaces in them:\n * an interrupted conversion said `Files already written to \"/tmp/a very long destination\n * folder name with` / `many spaces here indeed\" are incomplete`, splitting the one thing on\n * the line that has to be copied whole — and quoting is what a path with spaces in it is\n * given in the first place. A word wider than the column already overruns rather than\n * breaking; this is that rule reaching the words it was written for.\n *\n * Which is also why the gap between two words is reproduced rather than normalised to one\n * space. Splitting on `\\s+` and rejoining with `' '` re-flowed everything, and a quoted value\n * is not prose: a channel labelled `EEG  A` was offered back as `Did you mean \"EEG A\"?`, and\n * a destination given as `-my  nightly` as `Write it as one argument instead:\n * '--out=-my nightly'`. Following either gets a different channel or a different directory\n * than the one the sentence is about, and the run before it had already quoted the name\n * correctly on the line above.\n */\nexport function wrap(text: string, indent = '', width = WRAP_COLUMNS): string {\n  const lines: string[] = [];\n  let line = indent;\n  let at = 0;\n  for (const match of text.matchAll(WORD)) {\n    const piece = match[0];\n    const gap = text.slice(at, match.index);\n    at = match.index + piece.length;\n    if (line === indent) line += piece;\n    else if (line.length + gap.length + piece.length <= width) line += gap + piece;\n    else {\n      lines.push(line);\n      line = indent + piece;\n    }\n  }\n  if (line !== indent) lines.push(line);\n  return lines.join('\\n');\n}\n\nfunction table(rows: readonly (readonly string[])[], alignRight: ReadonlySet<number>): string {\n  if (rows.length === 0) return '';\n  const width: number[] = [];\n  for (const row of rows) {\n    row.forEach((cell, i) => {\n      width[i] = Math.max(width[i] ?? 0, cell.length);\n    });\n  }\n  return rows\n    .map((row) =>\n      row\n        .map((cell, i) => {\n          const w = width[i] ?? 0;\n          return alignRight.has(i) ? cell.padStart(w) : cell.padEnd(w);\n        })\n        .join('  ')\n        .trimEnd(),\n    )\n    .join('\\n');\n}\n\n/**\n * Make header text safe to print to a terminal.\n *\n * EDF identification fields and channel labels are free text copied verbatim out of the\n * file, and `--info` puts them straight on stdout. A header carrying ANSI escapes could\n * therefore drive the reader's terminal — `\\x1b[2J\\x1b[H` clears the screen and homes the\n * cursor, which is enough to hide the rest of the output or repaint it as something else.\n * Nobody writes an EDF header that way on purpose, which is exactly why a file that does\n * should not be trusted with the terminal.\n *\n * Control bytes are shown as their escape instead, so a corrupt field stays diagnosable\n * rather than being silently swallowed. This affects display only: `channels.csv` and\n * `metadata.json` still copy the field verbatim, and CSV quoting already makes that safe.\n */\n// Defined in src/format/unprintable.ts, beside the character class it uses, since the library's\n// own message builders need it too — see 0.8.92. Re-exported here, which is where every caller\n// in this package already imports it from.\nexport { printable };\n\n/**\n * The same protection for text that is meant to span lines.\n *\n * `printable` escapes newlines along with everything else, which is right for a channel\n * label — one has no business containing a line break, and it would break the `--info`\n * table's alignment. It is wrong for a whole message: several are written on two lines,\n * and Node's own option errors run to three. Escaping those turned the break into text:\n *\n *     error: No channel named \"ECQ\". Did you mean \"ECG\"?\\x0aRun with --info to list ...\n *\n * Each line is escaped on its own, so nothing here gains the ability to drive a terminal.\n * A carriage return is still escaped, so no line can be repainted after it is printed —\n * which is the property that mattered. A newline can only add a line, never overwrite one.\n */\nexport function printableLines(text: string, indent = ''): string {\n  return text\n    .split('\\n')\n    .map((line, index) => {\n      const safe = printable(line);\n      // The first line is the one that follows `error: ` or `warning: `, so it is the line\n      // a log gets grepped for, and it stays whole at whatever width it runs to.\n      if (index === 0) return safe;\n\n      /*\n        Callers write the continuation indent one of two ways: most pass it here and leave\n        their message lines flush, but the two usage builders bake `       ` into the string\n        itself because they are printed without an `error: ` prefix in front. Reading the\n        line's own leading space when none was passed keeps both working, and keeps the\n        wrap aligned under the same column either way.\n      */\n      const body = safe.trimStart();\n      const pad = indent === '' ? safe.slice(0, safe.length - body.length) : indent;\n\n      /*\n        A continuation that is a command is copied, not read.\n\n        `edf2csv -- \"--chanels\"` is the line the unknown-option error ends on, and it exists\n        to be pasted back into the shell. Wrapping puts `edf2csv --` on one line and the\n        flag on the next, and what gets pasted is half a command. Prose survives being\n        re-flowed and a command does not, so the two are told apart rather than being\n        treated alike and hoping today's strings stay short.\n      */\n      if (body.startsWith('edf2csv ')) return pad + body;\n      return wrap(body, pad);\n    })\n    .join('\\n');\n}\n\n/** The `--info` view: what is in this recording, and what would converting it produce. */\nexport function formatInfo(\n  file: EdfFile,\n  plan: ConversionPlan,\n  /**\n   * How many events a conversion would write, when that is already known.\n   *\n   * Null when it is not. `--info` reads the whole annotation channel of a discontinuous file,\n   * because that is where its record times are; a continuous one it reads only far enough to\n   * find the origin. So the count is in hand for one of the two, and the line below said \"How\n   * many events there are cannot be told from the header\" for both — true of the header, and\n   * beside the point on a file whose events had just been read and counted.\n   */\n  events: number | null = null,\n  /**\n   * Whether the run would stream to stdout, in which case no file is written at all.\n   *\n   * The OUTPUT column is \"Named as they will be written. --info is read to find out what a\n   * run leaves behind, and a script that opens the name it was given must find a file there\"\n   * — and under `--stdout` it named `signals.csv`, or `signals.csv.gz`, for a run that\n   * creates no directory and no file. The same table already tells a channel that will not\n   * be converted from one the file gives nothing to convert; this is the third thing it\n   * could not say.\n   */\n  toStdout = false,\n): string {\n  const { header } = file;\n  const lines: string[] = [];\n\n  /*\n    Escaped, like every other value that came out of the filesystem.\n\n    A path is untrusted text: a folder may be named with an ESC byte, and a file name may\n    hold a newline on every platform this runs on. The `[n/m]` header a batch prints has\n    always escaped it and these two lines did not, so one line of a run reached the terminal\n    as `study/esc\\x1b[31mred.edf` and the next as a live colour change — and a name holding a\n    newline split `Wrote` across two lines, so the summary reported a path that reads as two.\n    NONPRINTABLE_LABEL exists because a header field can carry these bytes; a directory entry\n    can carry them just as easily.\n  */\n  lines.push(`File       ${printable(file.path)}`);\n  lines.push(`Format     ${describeFormat(header)}`);\n  /*\n    The two raw fields, with edges.\n\n    Echoed bare, they ran into each other and into the parenthetical, and a header field is\n    free to be empty or to be nothing but padding — `trimField` takes the padding off, so\n    both of those arrive here as \"\". A file whose date field is blank printed\n\n        Recorded    22.15.00 (unparseable)\n\n    where the one value on the line is the *time* and nothing says so, and a file with both\n    blank printed `Recorded     (unparseable)`: a label, a gap, and a verdict about nothing\n    visible. `  .  .  ` in both fields came out `.  . .  .`, which is four fields or two\n    depending on how the reader counts.\n\n    Quoted, which is what `START_TIME_UNREADABLE` — the warning printed under this very line,\n    about these very fields — has always done: `(\"\" and \"\")`. Same argument 0.7.x made for the\n    time-range refusals, in its words: without them \"the value ran into the sentence ... and\n    the surrounding spaces — the actual reason a shell-built argument went wrong — are\n    invisible\". `--info --json` has the two as separate strings and never had the problem.\n  */\n  lines.push(\n    `Recorded   ${\n      formatWallClock(header.startDateTime)?.replace('T', ' ') ??\n      `\"${printable(header.startDateRaw)}\" \"${printable(header.startTimeRaw)}\" (unparseable)`\n    }`,\n  );\n  lines.push(\n    `Duration   ${formatDuration(file.durationSeconds)}  (${counted(file.recordCount, 'record')} of ${plainSeconds(header.recordDuration)}s)`,\n  );\n  const elapsedSpan = plan.range.recordingEndSeconds - plan.range.recordingStartSeconds;\n  if (Math.abs(elapsedSpan - file.durationSeconds) > 1e-9) {\n    /*\n      Which way the two differ decides what to call it, and the parenthetical used to say\n      \"includes discontinuities\" both ways round.\n\n      A span LONGER than the duration is the gap case this line was written for: 3 records of\n      1s covering 11 seconds. A span SHORTER than the duration cannot be a gap — it is records\n      that overlap, which an EDF+D file gets when a device re-sends a buffer. Three records of\n      1s starting at 0, 0.5 and 1 print:\n\n          Duration   3s  (3 records of 1s)\n          Time span  2s  (includes discontinuities)\n\n      A recording covering less time than its own records account for, blamed on gaps it does\n      not have — while the warning below it says, correctly, that two records overlap.\n\n      A file holding both is described by whichever wins the subtraction, and the overlap\n      warning is printed either way.\n    */\n    const overlapping = elapsedSpan < file.durationSeconds;\n    lines.push(\n      `Time span  ${formatDuration(elapsedSpan)}  ` +\n        `(${overlapping ? 'records overlap in time' : 'includes discontinuities'})`,\n    );\n  }\n  /*\n    Where the samples begin, when that is not zero.\n\n    0.4.9 made the first record's timekeeping TAL the point a recording is timed from, so a\n    file whose TALs start at +1000 writes `time_s` from 1000.000 and takes `--start` and\n    `--end` on that same clock. None of that appeared here: the report said \"Duration 3s\",\n    which reads as 0 to 3, and `--start 0 --end 1` then selected nothing and answered with\n    \"The window is inside the recording but lands where there is no data ... Run with --info\n    to see where the records actually sit\" — pointing at this report, which was the one place\n    the number was missing. It is in `plan.range` already and governs the estimate printed\n    below; it was simply never shown.\n  */\n  const startsAt = plan.range.recordingStartSeconds;\n  if (Number.isFinite(startsAt) && Math.abs(startsAt) > 1e-9) {\n    // In seconds rather than through formatDuration, because this number is meant to be\n    // typed back in: `--start` takes `1000s`, and \"16m 40s\" is not something it accepts.\n    // It is also how the empty-window warning renders the window it was given.\n    //\n    // Through `fixed` rather than `toFixed`, which switches to exponent notation at 1e21 —\n    // and `--start 1e+21s` is refused by the time parser with \"uses an unknown unit \\\"e\\\"\",\n    // so the one line that says which clock to use handed back a number that clock rejects.\n    // Reachable from a conforming file: an EDF+ onset is plain digits of any length, and a\n    // record duration large enough to keep samples apart at that magnitude is four\n    // characters. `fixed` expands these with BigInt, which is exact past 2^53 where a double\n    // carries no fraction anyway, and is byte-for-byte `toFixed` everywhere else.\n    lines.push(\n      `Timed from ${fixed(startsAt, 3)}s  (first sample; --start and --end use this clock)`,\n    );\n  }\n  /*\n    And the window, when one was asked for, which this report did not mention at all.\n\n    `--info` is the mode whose purpose is to say what a conversion will do, and every other\n    flag that changes what gets written is visible in it: `--channels` puts `(not selected)`\n    in the OUTPUT column, `--gzip` changes the names there, `--layout long` changes the\n    sentence under the table, `--annotations-only` replaces the estimate outright. `--start`\n    and `--end` changed one number:\n\n        $ edf2csv rec.edf --info                    $ edf2csv rec.edf --info --start 1s --end 2s\n        Duration   3s  (3 records of 1s)            Duration   3s  (3 records of 1s)\n        ...                                         ...\n        Would write 1,155 rows, roughly 22.2 KB.    Would write 385 rows, roughly 7.4 KB.\n\n    Byte-for-byte identical otherwise — and the Duration line, which is what a reader checks a\n    window against, goes on describing the whole file above an estimate that describes a third\n    of it. The window is in `plan.range` already, which is the same thing `Timed from` above\n    was added for: it governs the estimate printed below and was simply never shown.\n\n    In seconds rather than through `formatDuration`, for the reason that line gives: these are\n    numbers meant to be typed back into `--start` and `--end`, and \"16m 40s\" is not one.\n  */\n  const { range } = plan;\n  /*\n    An end that a double cannot hold is still an end.\n\n    `endSeconds` is `recordCount * recordDuration` when no `--end` was given, and a header may\n    state a record duration of 1e308 in five characters — two of those records overflow, so\n    the figure comes back `Infinity`. This line required it to be finite and so vanished\n    altogether on exactly the recording whose estimate is hardest to account for: the whole\n    point of the line is to say why the row count changed, and `--start 1s` on such a file\n    changed it from 8 rows to 7 with nothing on screen to say a window had been asked for.\n\n    The window is still perfectly ordinary from this side — it begins where it was told to and\n    runs to the end of the recording, which is what the line says now.\n  */\n  const endsAtInfinity = !Number.isFinite(range.endSeconds);\n  if (!range.isWholeRecording && Number.isFinite(range.startSeconds)) {\n    /*\n      What the window selects, which is not data records in every mode.\n\n      `--annotations-only` reads the annotation channel and converts no data records at all —\n      the OUTPUT column of the table below says `(no signal data)` for every channel, and the\n      line under it says \"and no signal data\". This counted them anyway:\n\n          Window     1.000s to 3.000s  (2 of 3 data records)\n          ...\n          Would write annotations.csv and channels.csv, and no signal data.\n\n      The window is not idle in that mode: it decides which events are exported, by onset. So\n      the range stays and the parenthetical says what it is doing.\n    */\n    const selects = plan.writeSignals\n      ? `${grouped(range.endRecord - range.startRecord)} of ${counted(file.recordCount, 'data record')}`\n      : 'events outside it are not exported';\n    const to = endsAtInfinity ? 'the end' : `${fixed(range.endSeconds, 3)}s`;\n    lines.push(`Window     ${fixed(range.startSeconds, 3)}s to ${to}  (${selects})`);\n  }\n  lines.push(`Size       ${formatBytes(file.fileSize)}`);\n  if (header.patientId) lines.push(`Patient    ${printable(header.patientId)}`);\n  if (header.recordingId) lines.push(`Recording  ${printable(header.recordingId)}`);\n\n  const signals = file.dataSignals;\n  lines.push('');\n  /*\n    Both counts through `counted`, which this function already uses one line up for the record\n    count and which exists so a count and its noun cannot disagree.\n\n    The annotation-channel half was pluralised by hand when it was fixed — a file carrying two\n    of them read \"2 annotation channel\", and EDF+ permits more than one — and the signal half\n    had been hand-rolled since it was written. Two spellings of one rule in one line, in the\n    file that imports the rule.\n  */\n  const annotationCount = file.annotationSignals.length;\n  const annotationPart =\n    annotationCount > 0 ? ` + ${counted(annotationCount, 'annotation channel')}` : '';\n  lines.push(`Channels   ${counted(signals.length, 'signal')}${annotationPart}`);\n  lines.push('');\n\n  const rows: string[][] = [['#', 'COLUMN', 'LABEL', 'UNIT', 'RATE', 'RANGE', 'OUTPUT']];\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  // Rendered as a group so that two channels recorded at different rates never show the\n  // same figure in the RATE column, which is the one thing this table is asked to settle.\n  const rateText = formatRates(signals.map((signal) => signal.samplingRate));\n  for (const [row, signal] of signals.entries()) {\n    rows.push([\n      String(signal.index),\n      printable(plan.columnNames.get(signal.index) ?? ''),\n      printable(signal.label),\n      printable(signal.physicalDimension),\n      `${rateText[row]} Hz`,\n      `${signal.physicalMin} to ${signal.physicalMax}`,\n      /*\n        A channel with no samples was reported as \"(not selected)\", which is a different\n        thing and not true when it was named on --channels. `edf2csv rec.edf --info\n        --channels unused` said the channel the command asked for had not been chosen, when\n        what is actually the case is that the file gives it nothing to convert. The\n        NO_SAMPLES warning below the table says so; the table contradicted it.\n      */\n      /*\n        And under --annotations-only nothing was deselected either — the run writes no signal\n        table at all, which is the same distinction one paragraph up.\n\n        `--info --annotations-only --channels \"EEG Fpz-Cz\"` accepted the name, checked it\n        against the file, and then printed \"(not selected)\" against the very channel it had\n        just been asked for. The sentence three lines under the table already says the truth,\n        \"and no signal data\", and `channels.csv` and `--info --json` both say it too — the\n        cell is empty and `output_file` is null. The human table was the one place claiming a\n        choice nobody made.\n      */\n      plan.writeSignals\n        ? fileFor.has(signal.index)\n          ? toStdout\n            ? '(stdout)'\n            : (fileFor.get(signal.index) as string)\n          : signal.samplesPerRecord === 0\n            ? '(no samples)'\n            : '(not selected)'\n        : '(no signal data)',\n    ]);\n  }\n  /*\n    A column head over nothing is not a table.\n\n    The line above has just said `Channels   0 signals + 1 annotation channel`, and this then\n    printed\n\n        #  COLUMN  LABEL  UNIT  RATE  RANGE  OUTPUT\n\n    with no row under it — seven headings for a set of no channels, on a recording holding\n    only events, which is what `annotations-only.edf` in this repository is and what a\n    companion event file out of a scoring system is. The same sentence `--channels \"#0\"` was\n    given its own wording for: \"No channel at position #0. This file has signal channels at\n    .\" states there are some and then names none.\n\n    Nothing goes in its place. The count is stated one line up and the body three lines down\n    says what the conversion would write; a table saying \"none\" twice more adds nothing.\n  */\n  if (signals.length > 0) {\n    lines.push(table(rows, new Set([0])));\n    lines.push('');\n  }\n  /*\n    From here down --info stops laying out columns and starts explaining itself, so from\n    here down it wraps. The key-value lines and the channel table above are aligned to each\n    other and must not be re-flowed; these are sentences, and the longest of them ran to 156\n    columns — which is not a line anyone reads, it is a line a terminal breaks somewhere.\n    --help has been written to 80 since it existed and hints joined it in 0.7.1; --info is\n    the mode whose whole purpose is being read by a person, and it was the last one guessing.\n  */\n  if (plan.groups.length > 1) {\n    /*\n      And the third thing this sentence could not say, after the OUTPUT column above it.\n\n      `--stdout` on a recording with more than one rate is refused — it writes one table and\n      this makes several — so no file is written and the run does not happen. The sentence\n      described it anyway, three lines under a column saying `(stdout)` and six above the\n      warning that the run would be refused:\n\n          0  EEG Fpz-Cz  ...  256 Hz  -250 to 250  (stdout)\n          Sampling rates differ, so channels are written to 3 files, one per rate.\n          warning: --stdout would refuse this run: needs exactly one table, but this\n                   recording produces 3 ...\n\n      Three statements about one run, and the middle one names an outcome none of the others\n      allows. What the rates decide is how many tables there are; where those go is the\n      question this mode has already answered differently.\n    */\n    lines.push(\n      wrap(\n        plan.layout === 'long'\n          ? `Sampling rates differ, and the long layout puts them in one table anyway: each row ` +\n            `carries its own time, so nothing has to line up. No channel is resampled.`\n          : toStdout\n            ? `Sampling rates differ, so this recording makes ${counted(plan.groups.length, 'table')}, ` +\n              `one per rate — more than --stdout can write. Converting into a directory writes one ` +\n              `file each; --layout long puts them all in one table.`\n            : `Sampling rates differ, so channels are written to ${counted(plan.groups.length, 'file')}, one per rate. ` +\n              `No channel is resampled.`,\n      ),\n    );\n  }\n  /*\n    The estimate describes the signal tables, and says so when that is not what will be\n    written.\n\n    Under --annotations-only there are no signal tables, and the line read \"Would write 0\n    rows, roughly 0 B.\" for a conversion that goes on to write annotations.csv with three\n    events in it. --info exists to say what a conversion will do; asserting it will write\n    nothing, when it will write a file, is the one thing it must not do.\n\n    How many events there are cannot be answered from the header — the annotation channel has\n    to be read record by record, which is the scan --info is for avoiding. So it says which\n    file, and that the count is not knowable this cheaply, rather than inventing a zero.\n  */\n  /*\n    No signal table to describe, whichever way that came about.\n\n    This asked only whether `--annotations-only` had been given. A recording that has no\n    signal channels — one holding nothing but EDF+ annotations — has none either, and fell\n    through to the estimate line: \"Would write 0 rows, roughly 0 B.\" for a conversion that\n    goes on to write an annotations.csv with events in it, beside channels.csv and\n    metadata.json. That is the sentence 0.4.51 removed, arriving by the other route.\n  */\n  if (!plan.writeSignals || plan.groups.length === 0) {\n    // Named as they will be written. --info is read to find out what a run leaves behind,\n    // and a script that opens the name it was given must find a file there.\n    const suffix = plan.gzip ? '.csv.gz' : '.csv';\n    lines.push(\n      wrap(\n        file.annotationSignals.length > 0\n          ? events === null\n            ? `Would write annotations${suffix} and channels${suffix}, and no signal data. How ` +\n              'many events there are cannot be told from the header, and finding out means ' +\n              'reading the annotation channel record by record.'\n            : `Would write annotations${suffix} with ${counted(events, 'event')} and ` +\n              `channels${suffix}, and no signal data.`\n          : `Would write channels${suffix} and no signal data — and no annotations${suffix} ` +\n            'either, since this recording has no annotation channel.',\n      ),\n    );\n    return lines.join('\\n');\n  }\n\n  // The estimate counts the characters of the CSV, which is what --gzip then compresses.\n  // Reporting it as the size on disk would overstate a compressed conversion several-fold.\n  const compressing = plan.gzip;\n  lines.push(\n    wrap(\n      // A window narrow enough to select one sample is an ordinary thing to ask for, and this\n      // read \"Would write 1 rows, roughly 22 B.\" — the slip 0.5.74 fixed on the lines above it\n      // and missed here, because the recording that test builds never estimates exactly one.\n      `Would write ${counted(plan.estimate.rows, 'row')}, roughly ` +\n        `${formatBytes(plan.estimate.bytes)}${compressing ? ' before compression' : ''}.`,\n    ),\n  );\n\n  return lines.join('\\n');\n}\n\n/**\n * The `--info` view as JSON, for surveying files from a script.\n *\n * `indent` is 2 for a single recording, matching what this has always printed, and null for\n * a batch — several pretty-printed documents run together are readable by a streaming parser\n * but not by anything that expects one record per line, and a batch is exactly where\n * line-oriented reading is wanted. null rather than undefined because a default parameter\n * takes effect when undefined is passed, which quietly restored the indentation this was\n * meant to drop; JSON.stringify itself wants undefined, so it is translated at the call.\n *\n * `--info` answers \"what is in this recording and what would converting it cost\", which\n * is exactly the question you want to ask across a directory of hundreds of recordings —\n * and the text table is the wrong shape for that. `--json` previously applied only to\n * conversions, so scripts had to parse the aligned columns or convert files just to learn\n * what was in them.\n *\n * Field names match `metadata.json` where the two describe the same thing, so a survey and\n * a conversion can be read by the same code.\n */\nexport function infoJson(\n  file: EdfFile,\n  plan: ConversionPlan,\n  /**\n   * The event count, on the files where `--info` has already read and counted them.\n   *\n   * `formatInfo` has taken this since 0.7.x and prints it — \"Would write annotations.csv with\n   * 3 events\" — and the same number was dropped on the way to the JSON, which is the surface\n   * a script reads and the reason `--info --json` exists. Null where the count is not in\n   * hand, by the same rule `estimate` is null for a run that writes no signal table: a\n   * continuous file is read only as far as its origin, so its events have not been counted\n   * and there is no honest number to put here.\n   */\n  events: number | null = null,\n  indent: number | null = 2,\n  /** See `formatInfo`: under `--stdout` there is no file to name. */\n  toStdout = false,\n): string {\n  const { header } = file;\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 document = JSON.stringify(\n    {\n      tool: TOOL,\n      path: file.path,\n      bytes: file.fileSize,\n      format: describeFormat(header),\n      start_datetime_local: formatWallClock(header.startDateTime),\n      start_date_raw: header.startDateRaw,\n      start_time_raw: header.startTimeRaw,\n      patient_id: header.patientId,\n      recording_id: header.recordingId,\n      data_records: file.recordCount,\n      data_records_declared: header.declaredRecordCount,\n      record_duration_seconds: header.recordDuration,\n      duration_seconds: file.durationSeconds,\n      // For a discontinuous file this exceeds duration_seconds by the length of the gaps.\n      time_span_seconds: plan.range.recordingEndSeconds - plan.range.recordingStartSeconds,\n      // Where `time_s` begins, and the clock `--start` and `--end` are read against. Usually\n      // zero; not when the first record's timekeeping TAL puts the recording elsewhere. Both\n      // of the fields above are lengths and neither says where that length sits.\n      first_sample_seconds: plan.range.recordingStartSeconds,\n      /*\n        The window, under the names `metadata.json` gives it, which is the rule this document\n        follows for everything describing the run.\n\n        The text form did not show it either until 0.8.82; here the only trace of `--start`\n        and `--end` was `estimate.rows` coming back smaller, with nothing in the document\n        saying why. A survey that runs `--info --json` over a folder with a window on the\n        command line archives a description of each recording in which the window does not\n        appear.\n      */\n      start_seconds: plan.range.startSeconds,\n      end_seconds: plan.range.endSeconds,\n      whole_recording: plan.range.isWholeRecording,\n      annotation_channels: file.annotationSignals.length,\n      // Named as `summaryJson` names the same count, so a prediction and a conversion read\n      // the same field.\n      annotations: events,\n      channels: file.dataSignals.map((signal) => ({\n        signal_index: signal.index,\n        column: plan.columnNames.get(signal.index) ?? '',\n        label: signal.label,\n        unit: signal.physicalDimension,\n        sampling_rate_hz: signal.samplingRate,\n        samples_per_record: signal.samplesPerRecord,\n        physical_min: signal.physicalMin,\n        physical_max: signal.physicalMax,\n        digital_min: signal.digitalMin,\n        digital_max: signal.digitalMax,\n        transducer: signal.transducer,\n        prefiltering: signal.prefiltering,\n        /*\n          `-`, the placeholder `ConvertResult.outputDir` already uses for this mode, and not\n          `null`: null is this document's word for \"would not be converted\", which is a\n          different thing from \"converted, to a stream\".\n        */\n        output_file: fileFor.has(signal.index)\n          ? toStdout\n            ? '-'\n            : (fileFor.get(signal.index) as string)\n          : null,\n      })),\n      /*\n        Null rather than zero when the run writes no signal table.\n\n        The text form has refused to say \"Would write 0 rows, roughly 0 B.\" since 0.4.51,\n        because a run that goes on to write an annotations.csv with events in it has not\n        written nothing — and it is `--annotations-only`, or a recording holding only\n        annotations, that reaches this. The JSON went on saying it to the surface a script\n        reads. There is no estimate for a table that does not exist, and null is how this\n        document already says that.\n      */\n      estimate:\n        plan.writeSignals && plan.groups.length > 0\n          ? {\n              rows: plan.estimate.rows,\n              // Character count of the CSV. With --gzip the file on disk is smaller than this.\n              bytes: plan.estimate.bytes,\n              exceeds_spreadsheet_limit: plan.estimate.exceedsSpreadsheetLimit,\n            }\n          : { rows: null, bytes: null, exceeds_spreadsheet_limit: false },\n      // The plan's mixed-rate warning replaces the header parser's, as it does everywhere\n      // else. This was the one consumer left out of that when 0.3.2 made the warning follow\n      // --channels, so `--info --json` carried it twice: once counting the rates being\n      // converted and once counting every rate in the file, with the same code and severity.\n      // The file's own first, then the plan's, which is the order the text form prints them\n      // in. Concatenating the other way round listed the same warnings about the same\n      // recording in two different sequences depending on which form you asked for.\n      warnings: withoutFileRateWarning(file.diagnostics)\n        .concat(plan.diagnostics)\n        .map((d) => ({ code: d.code, severity: d.severity, message: d.message })),\n    },\n    null,\n    indent ?? undefined,\n  );\n  // A path is untrusted text on this surface too; see escapeJsonText.\n  return escapeJsonText(document);\n}\n\n/**\n * One diagnostic per `warning: ` line, prefixed so warnings are greppable; the hint below it\n * wrapped to the terminal.\n *\n * The hint has been on its own unprefixed continuation line since these gained hints at all,\n * so grepping for `warning:` never picked it up and wrapping it costs nothing that was being\n * relied on — which is what 0.6.132 got wrong when it left every diagnostic long on the\n * grounds that they are one line each. Half of that is true. The `warning:` head is a line\n * per diagnostic and stays one, at whatever width the message runs to; the hint underneath\n * it is prose addressed to a person reading a terminal, and 17 of them ran past 80 columns,\n * the widest to 180. At that width the second half of the advice is wherever the terminal\n * decided to put it, indented under nothing, and the 9-space rule that says \"this belongs to\n * the warning above\" is lost at exactly the moment there is enough text for it to matter.\n */\nexport function formatDiagnostics(diagnostics: readonly Diagnostic[]): string {\n  return diagnostics\n    .map((d) => {\n      // Diagnostics quote channel labels, which come from the file, so they need the\n      // same treatment as the --info table.\n      const head = `${d.severity}: ${printable(d.message)}`;\n      return d.hint ? `${head}\\n${wrap(printable(d.hint), HINT_INDENT)}` : head;\n    })\n    .join('\\n');\n}\n\nexport function formatSummary(result: ConvertResult): string {\n  const lines: string[] = [];\n  const rows: string[][] = [];\n  for (const file of result.files) {\n    // `.csv.gz` is still a CSV, and its rows are still rows. The suffix test dropped the\n    // unit from every line of a --gzip summary, so the numbers stood on their own.\n    rows.push([\n      `  ${file.name}`,\n      grouped(file.rows),\n      // Singular at one, like every other count this prints: a one-row table is what a\n      // narrow window produces, and \"1 rows\" is the same slip 0.5.74 fixed elsewhere.\n      /\\.csv(\\.gz)?$/u.test(file.name) ? (file.rows === 1 ? 'row' : 'rows') : '',\n    ]);\n  }\n  lines.push(`Wrote ${printable(result.outputDir)}`);  // Escaped; see the File line above.\n  lines.push(table(rows, new Set([1])));\n  lines.push(`Done in ${elapsed(result.elapsedMs)}.`);\n  return lines.join('\\n');\n}\n\n/**\n * How long the run took, in a unit it can be stated in.\n *\n * `elapsedMs` is a difference of two `Date.now()` readings, so it is whole milliseconds, and\n * `(ms / 1000).toFixed(1)` rounds everything under fifty of them to `0.0`. That is the last\n * line of every conversion of a small recording — `--annotations-only` on a three-record\n * file, every fixture in this repository, and the transcript on three documentation pages,\n * all of which read `Done in 0.0s.` for a run that read a file and wrote three.\n *\n * The same refusal `formatDuration` and `formatBytes` make one file over, and for the reason\n * stated there: none of them is a rounding rule, and each declines to print a form the\n * quantity cannot take — 1023.999 KB is not \"1024 KB\", two records of 1e-15s are not \"0s\",\n * and a conversion that happened did not take no time.\n *\n * A clock that reports no change at all has measured something below what it can resolve,\n * which is a different statement from zero and is what it says.\n */\nexport function elapsed(milliseconds: number): string {\n  /*\n    And the other end of it, which could only say seconds.\n\n    This is the one place in the tool that states a length of time without `formatDuration`,\n    and it is the line under a summary whose `Duration` field is printed *with* it. A\n    conversion of an overnight recording read:\n\n        Duration   8h 00m 0s  (28800 records of 1s)\n        ...\n        Done in 412.7s.\n\n    Two lengths of time on one screen, one decomposed and one not, from the same program. 412\n    seconds is a number a reader has to divide by sixty to hold, which is the whole reason\n    `formatDuration` exists and the same complaint `grouped` makes about counts.\n\n    Handed over at a minute, since below that the seconds are the readable form — and rounded\n    to the tenth this already prints first, because `formatDuration` keeps three decimals and\n    \"6m 52.734s\" claims a precision two `Date.now()` readings do not have.\n  */\n  if (milliseconds >= 60_000) return formatDuration(Math.round(milliseconds / 100) / 10);\n  if (milliseconds >= 50) return `${(milliseconds / 1000).toFixed(1)}s`;\n  return milliseconds > 0 ? `${milliseconds}ms` : 'under 1ms';\n}\n\n/**\n * Which version produced this record.\n *\n * `metadata.json` has carried it since the file existed, because a conversion should be\n * reproducible later. The two JSON *streams* did not, and they are the ones most likely to\n * outlive the run: `--json` exists to be piped into something, logged, or committed beside a\n * result, where the question a year on is which release's field names and rounding these are.\n * The same shape as metadata.json's, so a consumer reads one field either way.\n */\nconst TOOL = { name: 'edf2csv', version: VERSION } as const;\n\nexport function summaryJson(result: ConvertResult, indent: number | null = 2): string {\n  const document = JSON.stringify(\n    {\n      tool: TOOL,\n      output_dir: result.outputDir,\n      files: result.files,\n      annotations: result.annotationCount,\n      duration_seconds: result.file.durationSeconds,\n      records: result.file.recordCount,\n      elapsed_ms: result.elapsedMs,\n      warnings: result.diagnostics.map((d) => ({ code: d.code, severity: d.severity, message: d.message })),\n    },\n    null,\n    indent ?? undefined,\n  );\n  // A path is untrusted text on this surface too; see escapeJsonText.\n  return escapeJsonText(document);\n}\n"]}
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Human-readable output for the terminal.\n *\n * Everything here is plain text with no colour codes, so piping to a file or a log\n * produces exactly what appeared on screen.\n */\n\nimport type { Diagnostic } from '../edf/errors.js';\nimport type { EdfFile } from '../edf/reader.js';\nimport { describeFormat, formatRates, formatWallClock } from '../edf/header.js';\nimport { fixed, formatBytes, formatDuration, plainSeconds } from '../format/number.js';\nimport { counted, grouped } from '../format/list.js';\nimport { escapeJsonText, printable } from '../format/unprintable.js';\nimport type { ConversionPlan } from '../convert/plan.js';\nimport { withoutFileRateWarning } from '../convert/plan.js';\nimport type { ConvertResult } from '../convert/run.js';\nimport { VERSION } from '../version.js';\n\n/** Where terminal prose wraps. The width --help is written to, and the ANSI default. */\nconst WRAP_COLUMNS = 80;\n\n/** The continuation indent under a `warning: ` prefix, which is the only one there is. */\nconst HINT_INDENT = ' '.repeat(9);\n\n/**\n * One unbreakable unit of a wrapped line: a quoted span, or a run of non-space.\n *\n * The lookbehind is what keeps an apostrophe out of it. `the file's own header and it's` has\n * two of them, and without the guard `'s own header and it'` is one quoted span — a token\n * with spaces in it that then refuses to break. A quote opening a span is at the start of a\n * word, so that is what is required of it.\n */\nconst WORD = /(?<=^|[\\s(])(?:\"[^\"]*\"|'[^']*')|\\S+/gu;\n\n/**\n * Greedy word wrap, `indent` on every line including the first.\n *\n * Only free prose goes through this. The aligned parts of `--info` — the `Format`/`Size`\n * key-value lines and the channel table — are laid out in columns, and re-flowing a column\n * is how you turn a table into a paragraph.\n *\n * A word wider than the column is left to overrun rather than broken. The long words here\n * are file paths and quoted channel labels, and neither survives being split across lines:\n * the point of printing a path is that it can be copied back out.\n *\n * A quoted span is one word for the same reason, however many spaces are inside it. The\n * sentence above is the promise, and it held only for the paths that have no spaces in them:\n * an interrupted conversion said `Files already written to \"/tmp/a very long destination\n * folder name with` / `many spaces here indeed\" are incomplete`, splitting the one thing on\n * the line that has to be copied whole — and quoting is what a path with spaces in it is\n * given in the first place. A word wider than the column already overruns rather than\n * breaking; this is that rule reaching the words it was written for.\n *\n * Which is also why the gap between two words is reproduced rather than normalised to one\n * space. Splitting on `\\s+` and rejoining with `' '` re-flowed everything, and a quoted value\n * is not prose: a channel labelled `EEG  A` was offered back as `Did you mean \"EEG A\"?`, and\n * a destination given as `-my  nightly` as `Write it as one argument instead:\n * '--out=-my nightly'`. Following either gets a different channel or a different directory\n * than the one the sentence is about, and the run before it had already quoted the name\n * correctly on the line above.\n */\nexport function wrap(text: string, indent = '', width = WRAP_COLUMNS): string {\n  const lines: string[] = [];\n  let line = indent;\n  let at = 0;\n  for (const match of text.matchAll(WORD)) {\n    const piece = match[0];\n    const gap = text.slice(at, match.index);\n    at = match.index + piece.length;\n    if (line === indent) line += piece;\n    else if (line.length + gap.length + piece.length <= width) line += gap + piece;\n    else {\n      lines.push(line);\n      line = indent + piece;\n    }\n  }\n  if (line !== indent) lines.push(line);\n  return lines.join('\\n');\n}\n\nfunction table(rows: readonly (readonly string[])[], alignRight: ReadonlySet<number>): string {\n  if (rows.length === 0) return '';\n  const width: number[] = [];\n  for (const row of rows) {\n    row.forEach((cell, i) => {\n      width[i] = Math.max(width[i] ?? 0, cell.length);\n    });\n  }\n  return rows\n    .map((row) =>\n      row\n        .map((cell, i) => {\n          const w = width[i] ?? 0;\n          return alignRight.has(i) ? cell.padStart(w) : cell.padEnd(w);\n        })\n        .join('  ')\n        .trimEnd(),\n    )\n    .join('\\n');\n}\n\n/**\n * Make header text safe to print to a terminal.\n *\n * EDF identification fields and channel labels are free text copied verbatim out of the\n * file, and `--info` puts them straight on stdout. A header carrying ANSI escapes could\n * therefore drive the reader's terminal — `\\x1b[2J\\x1b[H` clears the screen and homes the\n * cursor, which is enough to hide the rest of the output or repaint it as something else.\n * Nobody writes an EDF header that way on purpose, which is exactly why a file that does\n * should not be trusted with the terminal.\n *\n * Control bytes are shown as their escape instead, so a corrupt field stays diagnosable\n * rather than being silently swallowed. This affects display only: `channels.csv` and\n * `metadata.json` still copy the field verbatim, and CSV quoting already makes that safe.\n */\n// Defined in src/format/unprintable.ts, beside the character class it uses, since the library's\n// own message builders need it too — see 0.8.92. Re-exported here, which is where every caller\n// in this package already imports it from.\nexport { printable };\n\n/**\n * The same protection for text that is meant to span lines.\n *\n * `printable` escapes newlines along with everything else, which is right for a channel\n * label — one has no business containing a line break, and it would break the `--info`\n * table's alignment. It is wrong for a whole message: several are written on two lines,\n * and Node's own option errors run to three. Escaping those turned the break into text:\n *\n *     error: No channel named \"ECQ\". Did you mean \"ECG\"?\\x0aRun with --info to list ...\n *\n * Each line is escaped on its own, so nothing here gains the ability to drive a terminal.\n * A carriage return is still escaped, so no line can be repainted after it is printed —\n * which is the property that mattered. A newline can only add a line, never overwrite one.\n */\nexport function printableLines(text: string, indent = ''): string {\n  return text\n    .split('\\n')\n    .map((line, index) => {\n      const safe = printable(line);\n      // The first line is the one that follows `error: ` or `warning: `, so it is the line\n      // a log gets grepped for, and it stays whole at whatever width it runs to.\n      if (index === 0) return safe;\n\n      /*\n        Callers write the continuation indent one of two ways: most pass it here and leave\n        their message lines flush, but the two usage builders bake `       ` into the string\n        itself because they are printed without an `error: ` prefix in front. Reading the\n        line's own leading space when none was passed keeps both working, and keeps the\n        wrap aligned under the same column either way.\n      */\n      const body = safe.trimStart();\n      const pad = indent === '' ? safe.slice(0, safe.length - body.length) : indent;\n\n      /*\n        A continuation that is a command is copied, not read.\n\n        `edf2csv -- \"--chanels\"` is the line the unknown-option error ends on, and it exists\n        to be pasted back into the shell. Wrapping puts `edf2csv --` on one line and the\n        flag on the next, and what gets pasted is half a command. Prose survives being\n        re-flowed and a command does not, so the two are told apart rather than being\n        treated alike and hoping today's strings stay short.\n      */\n      if (body.startsWith('edf2csv ')) return pad + body;\n      return wrap(body, pad);\n    })\n    .join('\\n');\n}\n\n/** The `--info` view: what is in this recording, and what would converting it produce. */\nexport function formatInfo(\n  file: EdfFile,\n  plan: ConversionPlan,\n  /**\n   * How many events a conversion would write, when that is already known.\n   *\n   * Null when it is not. `--info` reads the whole annotation channel of a discontinuous file,\n   * because that is where its record times are; a continuous one it reads only far enough to\n   * find the origin. So the count is in hand for one of the two, and the line below said \"How\n   * many events there are cannot be told from the header\" for both — true of the header, and\n   * beside the point on a file whose events had just been read and counted.\n   */\n  events: number | null = null,\n  /**\n   * Whether the run would stream to stdout, in which case no file is written at all.\n   *\n   * The OUTPUT column is \"Named as they will be written. --info is read to find out what a\n   * run leaves behind, and a script that opens the name it was given must find a file there\"\n   * — and under `--stdout` it named `signals.csv`, or `signals.csv.gz`, for a run that\n   * creates no directory and no file. The same table already tells a channel that will not\n   * be converted from one the file gives nothing to convert; this is the third thing it\n   * could not say.\n   */\n  toStdout = false,\n): string {\n  const { header } = file;\n  const lines: string[] = [];\n\n  /*\n    Escaped, like every other value that came out of the filesystem.\n\n    A path is untrusted text: a folder may be named with an ESC byte, and a file name may\n    hold a newline on every platform this runs on. The `[n/m]` header a batch prints has\n    always escaped it and these two lines did not, so one line of a run reached the terminal\n    as `study/esc\\x1b[31mred.edf` and the next as a live colour change — and a name holding a\n    newline split `Wrote` across two lines, so the summary reported a path that reads as two.\n    NONPRINTABLE_LABEL exists because a header field can carry these bytes; a directory entry\n    can carry them just as easily.\n  */\n  lines.push(`File       ${printable(file.path)}`);\n  lines.push(`Format     ${describeFormat(header)}`);\n  /*\n    The two raw fields, with edges.\n\n    Echoed bare, they ran into each other and into the parenthetical, and a header field is\n    free to be empty or to be nothing but padding — `trimField` takes the padding off, so\n    both of those arrive here as \"\". A file whose date field is blank printed\n\n        Recorded    22.15.00 (unparseable)\n\n    where the one value on the line is the *time* and nothing says so, and a file with both\n    blank printed `Recorded     (unparseable)`: a label, a gap, and a verdict about nothing\n    visible. `  .  .  ` in both fields came out `.  . .  .`, which is four fields or two\n    depending on how the reader counts.\n\n    Quoted, which is what `START_TIME_UNREADABLE` — the warning printed under this very line,\n    about these very fields — has always done: `(\"\" and \"\")`. Same argument 0.7.x made for the\n    time-range refusals, in its words: without them \"the value ran into the sentence ... and\n    the surrounding spaces — the actual reason a shell-built argument went wrong — are\n    invisible\". `--info --json` has the two as separate strings and never had the problem.\n  */\n  lines.push(\n    `Recorded   ${\n      formatWallClock(header.startDateTime)?.replace('T', ' ') ??\n      `\"${printable(header.startDateRaw)}\" \"${printable(header.startTimeRaw)}\" (unparseable)`\n    }`,\n  );\n  lines.push(\n    `Duration   ${formatDuration(file.durationSeconds)}  (${counted(file.recordCount, 'record')} of ${plainSeconds(header.recordDuration)}s)`,\n  );\n  const elapsedSpan = plan.range.recordingEndSeconds - plan.range.recordingStartSeconds;\n  if (Math.abs(elapsedSpan - file.durationSeconds) > 1e-9) {\n    /*\n      Which way the two differ decides what to call it, and the parenthetical used to say\n      \"includes discontinuities\" both ways round.\n\n      A span LONGER than the duration is the gap case this line was written for: 3 records of\n      1s covering 11 seconds. A span SHORTER than the duration cannot be a gap — it is records\n      that overlap, which an EDF+D file gets when a device re-sends a buffer. Three records of\n      1s starting at 0, 0.5 and 1 print:\n\n          Duration   3s  (3 records of 1s)\n          Time span  2s  (includes discontinuities)\n\n      A recording covering less time than its own records account for, blamed on gaps it does\n      not have — while the warning below it says, correctly, that two records overlap.\n\n      A file holding both is described by whichever wins the subtraction, and the overlap\n      warning is printed either way.\n    */\n    const overlapping = elapsedSpan < file.durationSeconds;\n    lines.push(\n      `Time span  ${formatDuration(elapsedSpan)}  ` +\n        `(${overlapping ? 'records overlap in time' : 'includes discontinuities'})`,\n    );\n  }\n  /*\n    Where the samples begin, when that is not zero.\n\n    0.4.9 made the first record's timekeeping TAL the point a recording is timed from, so a\n    file whose TALs start at +1000 writes `time_s` from 1000.000 and takes `--start` and\n    `--end` on that same clock. None of that appeared here: the report said \"Duration 3s\",\n    which reads as 0 to 3, and `--start 0 --end 1` then selected nothing and answered with\n    \"The window is inside the recording but lands where there is no data ... Run with --info\n    to see where the records actually sit\" — pointing at this report, which was the one place\n    the number was missing. It is in `plan.range` already and governs the estimate printed\n    below; it was simply never shown.\n  */\n  const startsAt = plan.range.recordingStartSeconds;\n  if (Number.isFinite(startsAt) && Math.abs(startsAt) > 1e-9) {\n    // In seconds rather than through formatDuration, because this number is meant to be\n    // typed back in: `--start` takes `1000s`, and \"16m 40s\" is not something it accepts.\n    // It is also how the empty-window warning renders the window it was given.\n    //\n    // Through `fixed` rather than `toFixed`, which switches to exponent notation at 1e21 —\n    // and `--start 1e+21s` is refused by the time parser with \"uses an unknown unit \\\"e\\\"\",\n    // so the one line that says which clock to use handed back a number that clock rejects.\n    // Reachable from a conforming file: an EDF+ onset is plain digits of any length, and a\n    // record duration large enough to keep samples apart at that magnitude is four\n    // characters. `fixed` expands these with BigInt, which is exact past 2^53 where a double\n    // carries no fraction anyway, and is byte-for-byte `toFixed` everywhere else.\n    lines.push(\n      `Timed from ${fixed(startsAt, 3)}s  (first sample; --start and --end use this clock)`,\n    );\n  }\n  /*\n    And the window, when one was asked for, which this report did not mention at all.\n\n    `--info` is the mode whose purpose is to say what a conversion will do, and every other\n    flag that changes what gets written is visible in it: `--channels` puts `(not selected)`\n    in the OUTPUT column, `--gzip` changes the names there, `--layout long` changes the\n    sentence under the table, `--annotations-only` replaces the estimate outright. `--start`\n    and `--end` changed one number:\n\n        $ edf2csv rec.edf --info                    $ edf2csv rec.edf --info --start 1s --end 2s\n        Duration   3s  (3 records of 1s)            Duration   3s  (3 records of 1s)\n        ...                                         ...\n        Would write 1,155 rows, roughly 22.2 KB.    Would write 385 rows, roughly 7.4 KB.\n\n    Byte-for-byte identical otherwise — and the Duration line, which is what a reader checks a\n    window against, goes on describing the whole file above an estimate that describes a third\n    of it. The window is in `plan.range` already, which is the same thing `Timed from` above\n    was added for: it governs the estimate printed below and was simply never shown.\n\n    In seconds rather than through `formatDuration`, for the reason that line gives: these are\n    numbers meant to be typed back into `--start` and `--end`, and \"16m 40s\" is not one.\n  */\n  const { range } = plan;\n  /*\n    An end that a double cannot hold is still an end.\n\n    `endSeconds` is `recordCount * recordDuration` when no `--end` was given, and a header may\n    state a record duration of 1e308 in five characters — two of those records overflow, so\n    the figure comes back `Infinity`. This line required it to be finite and so vanished\n    altogether on exactly the recording whose estimate is hardest to account for: the whole\n    point of the line is to say why the row count changed, and `--start 1s` on such a file\n    changed it from 8 rows to 7 with nothing on screen to say a window had been asked for.\n\n    The window is still perfectly ordinary from this side — it begins where it was told to and\n    runs to the end of the recording, which is what the line says now.\n  */\n  const endsAtInfinity = !Number.isFinite(range.endSeconds);\n  if (!range.isWholeRecording && Number.isFinite(range.startSeconds)) {\n    /*\n      What the window selects, which is not data records in every mode.\n\n      `--annotations-only` reads the annotation channel and converts no data records at all —\n      the OUTPUT column of the table below says `(no signal data)` for every channel, and the\n      line under it says \"and no signal data\". This counted them anyway:\n\n          Window     1.000s to 3.000s  (2 of 3 data records)\n          ...\n          Would write annotations.csv and channels.csv, and no signal data.\n\n      The window is not idle in that mode: it decides which events are exported, by onset. So\n      the range stays and the parenthetical says what it is doing.\n    */\n    const selects = plan.writeSignals\n      ? `${grouped(range.endRecord - range.startRecord)} of ${counted(file.recordCount, 'data record')}`\n      : 'events outside it are not exported';\n    const to = endsAtInfinity ? 'the end' : `${fixed(range.endSeconds, 3)}s`;\n    lines.push(`Window     ${fixed(range.startSeconds, 3)}s to ${to}  (${selects})`);\n  }\n  lines.push(`Size       ${formatBytes(file.fileSize)}`);\n  if (header.patientId) lines.push(`Patient    ${printable(header.patientId)}`);\n  if (header.recordingId) lines.push(`Recording  ${printable(header.recordingId)}`);\n\n  const signals = file.dataSignals;\n  lines.push('');\n  /*\n    Both counts through `counted`, which this function already uses one line up for the record\n    count and which exists so a count and its noun cannot disagree.\n\n    The annotation-channel half was pluralised by hand when it was fixed — a file carrying two\n    of them read \"2 annotation channel\", and EDF+ permits more than one — and the signal half\n    had been hand-rolled since it was written. Two spellings of one rule in one line, in the\n    file that imports the rule.\n  */\n  const annotationCount = file.annotationSignals.length;\n  const annotationPart =\n    annotationCount > 0 ? ` + ${counted(annotationCount, 'annotation channel')}` : '';\n  lines.push(`Channels   ${counted(signals.length, 'signal')}${annotationPart}`);\n  lines.push('');\n\n  const rows: string[][] = [['#', 'COLUMN', 'LABEL', 'UNIT', 'RATE', 'RANGE', 'OUTPUT']];\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  // Rendered as a group so that two channels recorded at different rates never show the\n  // same figure in the RATE column, which is the one thing this table is asked to settle.\n  const rateText = formatRates(signals.map((signal) => signal.samplingRate));\n  for (const [row, signal] of signals.entries()) {\n    rows.push([\n      String(signal.index),\n      printable(plan.columnNames.get(signal.index) ?? ''),\n      printable(signal.label),\n      printable(signal.physicalDimension),\n      `${rateText[row]} Hz`,\n      `${signal.physicalMin} to ${signal.physicalMax}`,\n      /*\n        A channel with no samples was reported as \"(not selected)\", which is a different\n        thing and not true when it was named on --channels. `edf2csv rec.edf --info\n        --channels unused` said the channel the command asked for had not been chosen, when\n        what is actually the case is that the file gives it nothing to convert. The\n        NO_SAMPLES warning below the table says so; the table contradicted it.\n      */\n      /*\n        And under --annotations-only nothing was deselected either — the run writes no signal\n        table at all, which is the same distinction one paragraph up.\n\n        `--info --annotations-only --channels \"EEG Fpz-Cz\"` accepted the name, checked it\n        against the file, and then printed \"(not selected)\" against the very channel it had\n        just been asked for. The sentence three lines under the table already says the truth,\n        \"and no signal data\", and `channels.csv` and `--info --json` both say it too — the\n        cell is empty and `output_file` is null. The human table was the one place claiming a\n        choice nobody made.\n      */\n      plan.writeSignals\n        ? fileFor.has(signal.index)\n          ? toStdout\n            ? '(stdout)'\n            : (fileFor.get(signal.index) as string)\n          : signal.samplesPerRecord === 0\n            ? '(no samples)'\n            : '(not selected)'\n        : '(no signal data)',\n    ]);\n  }\n  /*\n    A column head over nothing is not a table.\n\n    The line above has just said `Channels   0 signals + 1 annotation channel`, and this then\n    printed\n\n        #  COLUMN  LABEL  UNIT  RATE  RANGE  OUTPUT\n\n    with no row under it — seven headings for a set of no channels, on a recording holding\n    only events, which is what `annotations-only.edf` in this repository is and what a\n    companion event file out of a scoring system is. The same sentence `--channels \"#0\"` was\n    given its own wording for: \"No channel at position #0. This file has signal channels at\n    .\" states there are some and then names none.\n\n    Nothing goes in its place. The count is stated one line up and the body three lines down\n    says what the conversion would write; a table saying \"none\" twice more adds nothing.\n  */\n  if (signals.length > 0) {\n    lines.push(table(rows, new Set([0])));\n    lines.push('');\n  }\n  /*\n    From here down --info stops laying out columns and starts explaining itself, so from\n    here down it wraps. The key-value lines and the channel table above are aligned to each\n    other and must not be re-flowed; these are sentences, and the longest of them ran to 156\n    columns — which is not a line anyone reads, it is a line a terminal breaks somewhere.\n    --help has been written to 80 since it existed and hints joined it in 0.7.1; --info is\n    the mode whose whole purpose is being read by a person, and it was the last one guessing.\n  */\n  if (plan.groups.length > 1) {\n    /*\n      And the third thing this sentence could not say, after the OUTPUT column above it.\n\n      `--stdout` on a recording with more than one rate is refused — it writes one table and\n      this makes several — so no file is written and the run does not happen. The sentence\n      described it anyway, three lines under a column saying `(stdout)` and six above the\n      warning that the run would be refused:\n\n          0  EEG Fpz-Cz  ...  256 Hz  -250 to 250  (stdout)\n          Sampling rates differ, so channels are written to 3 files, one per rate.\n          warning: --stdout would refuse this run: needs exactly one table, but this\n                   recording produces 3 ...\n\n      Three statements about one run, and the middle one names an outcome none of the others\n      allows. What the rates decide is how many tables there are; where those go is the\n      question this mode has already answered differently.\n    */\n    lines.push(\n      wrap(\n        plan.layout === 'long'\n          ? `Sampling rates differ, and the long layout puts them in one table anyway: each row ` +\n            `carries its own time, so nothing has to line up. No channel is resampled.`\n          : toStdout\n            ? `Sampling rates differ, so this recording makes ${counted(plan.groups.length, 'table')}, ` +\n              `one per rate — more than --stdout can write. Converting into a directory writes one ` +\n              `file each; --layout long puts them all in one table.`\n            : `Sampling rates differ, so channels are written to ${counted(plan.groups.length, 'file')}, one per rate. ` +\n              `No channel is resampled.`,\n      ),\n    );\n  }\n  /*\n    The estimate describes the signal tables, and says so when that is not what will be\n    written.\n\n    Under --annotations-only there are no signal tables, and the line read \"Would write 0\n    rows, roughly 0 B.\" for a conversion that goes on to write annotations.csv with three\n    events in it. --info exists to say what a conversion will do; asserting it will write\n    nothing, when it will write a file, is the one thing it must not do.\n\n    How many events there are cannot be answered from the header — the annotation channel has\n    to be read record by record, which is the scan --info is for avoiding. So it says which\n    file, and that the count is not knowable this cheaply, rather than inventing a zero.\n  */\n  /*\n    No signal table to describe, whichever way that came about.\n\n    This asked only whether `--annotations-only` had been given. A recording that has no\n    signal channels — one holding nothing but EDF+ annotations — has none either, and fell\n    through to the estimate line: \"Would write 0 rows, roughly 0 B.\" for a conversion that\n    goes on to write an annotations.csv with events in it, beside channels.csv and\n    metadata.json. That is the sentence 0.4.51 removed, arriving by the other route.\n  */\n  if (!plan.writeSignals || plan.groups.length === 0) {\n    // Named as they will be written. --info is read to find out what a run leaves behind,\n    // and a script that opens the name it was given must find a file there.\n    const suffix = plan.gzip ? '.csv.gz' : '.csv';\n    lines.push(\n      wrap(\n        file.annotationSignals.length > 0\n          ? events === null\n            ? `Would write annotations${suffix} and channels${suffix}, and no signal data. How ` +\n              'many events there are cannot be told from the header, and finding out means ' +\n              'reading the annotation channel record by record.'\n            : `Would write annotations${suffix} with ${counted(events, 'event')} and ` +\n              `channels${suffix}, and no signal data.`\n          : `Would write channels${suffix} and no signal data — and no annotations${suffix} ` +\n            'either, since this recording has no annotation channel.',\n      ),\n    );\n    return lines.join('\\n');\n  }\n\n  // The estimate counts the characters of the CSV, which is what --gzip then compresses.\n  // Reporting it as the size on disk would overstate a compressed conversion several-fold.\n  const compressing = plan.gzip;\n  lines.push(\n    wrap(\n      // A window narrow enough to select one sample is an ordinary thing to ask for, and this\n      // read \"Would write 1 rows, roughly 22 B.\" — the slip 0.5.74 fixed on the lines above it\n      // and missed here, because the recording that test builds never estimates exactly one.\n      `Would write ${counted(plan.estimate.rows, 'row')}, roughly ` +\n        `${formatBytes(plan.estimate.bytes)}${compressing ? ' before compression' : ''}.`,\n    ),\n  );\n\n  return lines.join('\\n');\n}\n\n/**\n * The `--info` view as JSON, for surveying files from a script.\n *\n * `indent` is 2 for a single recording, matching what this has always printed, and null for\n * a batch — several pretty-printed documents run together are readable by a streaming parser\n * but not by anything that expects one record per line, and a batch is exactly where\n * line-oriented reading is wanted. null rather than undefined because a default parameter\n * takes effect when undefined is passed, which quietly restored the indentation this was\n * meant to drop; JSON.stringify itself wants undefined, so it is translated at the call.\n *\n * `--info` answers \"what is in this recording and what would converting it cost\", which\n * is exactly the question you want to ask across a directory of hundreds of recordings —\n * and the text table is the wrong shape for that. `--json` previously applied only to\n * conversions, so scripts had to parse the aligned columns or convert files just to learn\n * what was in them.\n *\n * Field names match `metadata.json` where the two describe the same thing, so a survey and\n * a conversion can be read by the same code.\n */\nexport function infoJson(\n  file: EdfFile,\n  plan: ConversionPlan,\n  /**\n   * The event count, on the files where `--info` has already read and counted them.\n   *\n   * `formatInfo` has taken this since 0.7.x and prints it — \"Would write annotations.csv with\n   * 3 events\" — and the same number was dropped on the way to the JSON, which is the surface\n   * a script reads and the reason `--info --json` exists. Null where the count is not in\n   * hand, by the same rule `estimate` is null for a run that writes no signal table: a\n   * continuous file is read only as far as its origin, so its events have not been counted\n   * and there is no honest number to put here.\n   */\n  events: number | null = null,\n  indent: number | null = 2,\n  /** See `formatInfo`: under `--stdout` there is no file to name. */\n  toStdout = false,\n): string {\n  const { header } = file;\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 document = JSON.stringify(\n    {\n      tool: TOOL,\n      path: file.path,\n      bytes: file.fileSize,\n      format: describeFormat(header),\n      start_datetime_local: formatWallClock(header.startDateTime),\n      start_date_raw: header.startDateRaw,\n      start_time_raw: header.startTimeRaw,\n      patient_id: header.patientId,\n      recording_id: header.recordingId,\n      data_records: file.recordCount,\n      data_records_declared: header.declaredRecordCount,\n      record_duration_seconds: header.recordDuration,\n      duration_seconds: file.durationSeconds,\n      // For a discontinuous file this exceeds duration_seconds by the length of the gaps.\n      time_span_seconds: plan.range.recordingEndSeconds - plan.range.recordingStartSeconds,\n      // Where `time_s` begins, and the clock `--start` and `--end` are read against. Usually\n      // zero; not when the first record's timekeeping TAL puts the recording elsewhere. Both\n      // of the fields above are lengths and neither says where that length sits.\n      first_sample_seconds: plan.range.recordingStartSeconds,\n      /*\n        The window, under the names `metadata.json` gives it, which is the rule this document\n        follows for everything describing the run.\n\n        The text form did not show it either until 0.8.82; here the only trace of `--start`\n        and `--end` was `estimate.rows` coming back smaller, with nothing in the document\n        saying why. A survey that runs `--info --json` over a folder with a window on the\n        command line archives a description of each recording in which the window does not\n        appear.\n      */\n      start_seconds: plan.range.startSeconds,\n      end_seconds: plan.range.endSeconds,\n      whole_recording: plan.range.isWholeRecording,\n      annotation_channels: file.annotationSignals.length,\n      // Named as `summaryJson` names the same count, so a prediction and a conversion read\n      // the same field.\n      annotations: events,\n      channels: file.dataSignals.map((signal) => ({\n        signal_index: signal.index,\n        column: plan.columnNames.get(signal.index) ?? '',\n        label: signal.label,\n        unit: signal.physicalDimension,\n        sampling_rate_hz: signal.samplingRate,\n        samples_per_record: signal.samplesPerRecord,\n        physical_min: signal.physicalMin,\n        physical_max: signal.physicalMax,\n        digital_min: signal.digitalMin,\n        digital_max: signal.digitalMax,\n        transducer: signal.transducer,\n        prefiltering: signal.prefiltering,\n        /*\n          `-`, the placeholder `ConvertResult.outputDir` already uses for this mode, and not\n          `null`: null is this document's word for \"would not be converted\", which is a\n          different thing from \"converted, to a stream\".\n        */\n        output_file: fileFor.has(signal.index)\n          ? toStdout\n            ? '-'\n            : (fileFor.get(signal.index) as string)\n          : null,\n      })),\n      /*\n        Null rather than zero when the run writes no signal table.\n\n        The text form has refused to say \"Would write 0 rows, roughly 0 B.\" since 0.4.51,\n        because a run that goes on to write an annotations.csv with events in it has not\n        written nothing — and it is `--annotations-only`, or a recording holding only\n        annotations, that reaches this. The JSON went on saying it to the surface a script\n        reads. There is no estimate for a table that does not exist, and null is how this\n        document already says that.\n      */\n      estimate:\n        plan.writeSignals && plan.groups.length > 0\n          ? {\n              rows: plan.estimate.rows,\n              // Character count of the CSV. With --gzip the file on disk is smaller than this.\n              bytes: plan.estimate.bytes,\n              exceeds_spreadsheet_limit: plan.estimate.exceedsSpreadsheetLimit,\n            }\n          : { rows: null, bytes: null, exceeds_spreadsheet_limit: false },\n      // The plan's mixed-rate warning replaces the header parser's, as it does everywhere\n      // else. This was the one consumer left out of that when 0.3.2 made the warning follow\n      // --channels, so `--info --json` carried it twice: once counting the rates being\n      // converted and once counting every rate in the file, with the same code and severity.\n      // The file's own first, then the plan's, which is the order the text form prints them\n      // in. Concatenating the other way round listed the same warnings about the same\n      // recording in two different sequences depending on which form you asked for.\n      warnings: withoutFileRateWarning(file.diagnostics)\n        .concat(plan.diagnostics)\n        .map((d) => ({ code: d.code, severity: d.severity, message: d.message })),\n    },\n    null,\n    indent ?? undefined,\n  );\n  // A path is untrusted text on this surface too; see escapeJsonText.\n  return escapeJsonText(document);\n}\n\n/**\n * One diagnostic per `warning: ` line, prefixed so warnings are greppable; the hint below it\n * wrapped to the terminal.\n *\n * The hint has been on its own unprefixed continuation line since these gained hints at all,\n * so grepping for `warning:` never picked it up and wrapping it costs nothing that was being\n * relied on — which is what 0.6.132 got wrong when it left every diagnostic long on the\n * grounds that they are one line each. Half of that is true. The `warning:` head is a line\n * per diagnostic and stays one, at whatever width the message runs to; the hint underneath\n * it is prose addressed to a person reading a terminal, and 17 of them ran past 80 columns,\n * the widest to 180. At that width the second half of the advice is wherever the terminal\n * decided to put it, indented under nothing, and the 9-space rule that says \"this belongs to\n * the warning above\" is lost at exactly the moment there is enough text for it to matter.\n */\nexport function formatDiagnostics(diagnostics: readonly Diagnostic[]): string {\n  return diagnostics\n    .map((d) => {\n      // Diagnostics quote channel labels, which come from the file, so they need the\n      // same treatment as the --info table.\n      const head = `${d.severity}: ${printable(d.message)}`;\n      return d.hint ? `${head}\\n${wrap(printable(d.hint), HINT_INDENT)}` : head;\n    })\n    .join('\\n');\n}\n\nexport function formatSummary(result: ConvertResult): string {\n  const lines: string[] = [];\n  const rows: string[][] = [];\n  for (const file of result.files) {\n    // `.csv.gz` is still a CSV, and its rows are still rows. The suffix test dropped the\n    // unit from every line of a --gzip summary, so the numbers stood on their own.\n    rows.push([\n      `  ${file.name}`,\n      grouped(file.rows),\n      // Singular at one, like every other count this prints: a one-row table is what a\n      // narrow window produces, and \"1 rows\" is the same slip 0.5.74 fixed elsewhere.\n      /\\.csv(\\.gz)?$/u.test(file.name) ? (file.rows === 1 ? 'row' : 'rows') : '',\n    ]);\n  }\n  lines.push(`Wrote ${printable(result.outputDir)}`);  // Escaped; see the File line above.\n  lines.push(table(rows, new Set([1])));\n  lines.push(`Done in ${elapsed(result.elapsedMs)}.`);\n  return lines.join('\\n');\n}\n\n/**\n * How long the run took, in a unit it can be stated in.\n *\n * `elapsedMs` is a difference of two `Date.now()` readings, so it is whole milliseconds, and\n * `(ms / 1000).toFixed(1)` rounds everything under fifty of them to `0.0`. That is the last\n * line of every conversion of a small recording — `--annotations-only` on a three-record\n * file, every fixture in this repository, and the transcript on three documentation pages,\n * all of which read `Done in 0.0s.` for a run that read a file and wrote three.\n *\n * The same refusal `formatDuration` and `formatBytes` make one file over, and for the reason\n * stated there: none of them is a rounding rule, and each declines to print a form the\n * quantity cannot take — 1023.999 KB is not \"1024 KB\", two records of 1e-15s are not \"0s\",\n * and a conversion that happened did not take no time.\n *\n * A clock that reports no change at all has measured something below what it can resolve,\n * which is a different statement from zero and is what it says.\n */\nexport function elapsed(milliseconds: number): string {\n  /*\n    And the other end of it, which could only say seconds.\n\n    This is the one place in the tool that states a length of time without `formatDuration`,\n    and it is the line under a summary whose `Duration` field is printed *with* it. A\n    conversion of an overnight recording read:\n\n        Duration   8h 00m 0s  (28800 records of 1s)\n        ...\n        Done in 412.7s.\n\n    Two lengths of time on one screen, one decomposed and one not, from the same program. 412\n    seconds is a number a reader has to divide by sixty to hold, which is the whole reason\n    `formatDuration` exists and the same complaint `grouped` makes about counts.\n\n    Handed over at a minute, since below that the seconds are the readable form — and rounded\n    to the tenth this already prints first, because `formatDuration` keeps three decimals and\n    \"6m 52.734s\" claims a precision two `Date.now()` readings do not have.\n  */\n  /*\n    Rounded to the precision that will be printed, and only then given a form.\n\n    The branch was chosen at sixty thousand milliseconds and the seconds were rounded to one\n    decimal afterwards, so the last fifty milliseconds below the handover rounded up through\n    it: 59,950 to 59,999 printed `60.0s`, a minute stated in seconds, one millisecond under\n    the line that exists so a minute is stated as a minute.\n\n        Done in 60.0s.        59,999 ms\n        Done in 1m 0s.        60,000 ms\n\n    Which is the slip `formatBytes` fixed in the same words — \"Rounding can carry into the\n    next unit, and the unit was chosen before it: 1,048,575 bytes is 1023.999 KB, which\n    printed as 1024 KB\" — and the one the paragraph above cites as the rule this function\n    follows. Rounding first is what `formatDuration` does before it splits into hours and\n    minutes, for the same reason.\n  */\n  const tenths = Math.round(milliseconds / 100) / 10;\n  if (tenths >= 60) return formatDuration(tenths);\n  if (milliseconds >= 50) return `${tenths.toFixed(1)}s`;\n  return milliseconds > 0 ? `${milliseconds}ms` : 'under 1ms';\n}\n\n/**\n * Which version produced this record.\n *\n * `metadata.json` has carried it since the file existed, because a conversion should be\n * reproducible later. The two JSON *streams* did not, and they are the ones most likely to\n * outlive the run: `--json` exists to be piped into something, logged, or committed beside a\n * result, where the question a year on is which release's field names and rounding these are.\n * The same shape as metadata.json's, so a consumer reads one field either way.\n */\nconst TOOL = { name: 'edf2csv', version: VERSION } as const;\n\nexport function summaryJson(result: ConvertResult, indent: number | null = 2): string {\n  const document = JSON.stringify(\n    {\n      tool: TOOL,\n      output_dir: result.outputDir,\n      files: result.files,\n      annotations: result.annotationCount,\n      duration_seconds: result.file.durationSeconds,\n      records: result.file.recordCount,\n      elapsed_ms: result.elapsedMs,\n      warnings: result.diagnostics.map((d) => ({ code: d.code, severity: d.severity, message: d.message })),\n    },\n    null,\n    indent ?? undefined,\n  );\n  // A path is untrusted text on this surface too; see escapeJsonText.\n  return escapeJsonText(document);\n}\n"]}

package/dist/convert/time-range.js

@@ -222,7 +222,23 @@ function assertFinite(value, optionName, input, allowNegative) {
     if (!Number.isFinite(value)) {
         throw new TimeRangeError(`${optionName} "${input}" is further from zero than a number of seconds can hold.`);
     }
-    if (!allowNegative && value < 0) {
+    /*
+      Read as `=== true`, which is how every other flag in this package is read.
+  
+      A truthiness test takes a value that is not a boolean as the opposite of what it says, and
+      this is exported: `parseTimeSpec` is the function the api page tells other people to point
+      their own users at, so its third argument arrives from a config file, a query string or a
+      wrapper that did not coerce, exactly as `assertOptions` describes for the six flags —
+  
+          parseTimeSpec('-5s', '--duration', 'false')   // -5
+          parseTimeSpec('-5s', '--duration', 'no')      // -5
+          parseTimeSpec('-5s', '--duration', {})        // -5
+  
+      — and the value it lets through is a negative length of time, which is the one thing this
+      line exists to stop. `--duration -5s` from the command line is refused, because the CLI
+      passes a real boolean.
+    */
+    if (allowNegative !== true && value < 0) {
         throw new TimeRangeError(`${optionName} "${input}" is not a valid non-negative time.`);
     }
     return value;

package/dist/convert/time-range.js.map

@@ -1 +1 @@
-{"version":3,"file":"time-range.js","sourceRoot":"","sources":["../../src/convert/time-range.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Parsing for the time-range options.\n *\n * Researchers write offsets in whatever form is natural for the recording in front\n * of them: seconds for a short ECG strip, `30m` into a sleep study, `01:23:45` when\n * reading off a clock. All three are accepted; anything ambiguous is rejected with\n * a message that shows the forms that work.\n */\n\nimport { fixed, formatDuration, withinLine } from '../format/number.js';\nimport { assertOptions, assertRecordShape, describeValue, OptionError } from './options.js';\n\nexport class TimeRangeError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TimeRangeError';\n  }\n}\n\n/**\n * Every spelling of a unit this accepts, and what one of it is worth in seconds.\n *\n * Exported so the spellings can be enumerated by a test rather than listed a second time:\n * twelve of these sixteen are named nowhere in the tool or its documentation, and none of\n * their values was checked by anything. `hrs: 360` would have converted `--start 2hrs` from\n * twelve minutes in and said nothing, which is the one kind of mistake a window may not make.\n */\nexport const UNIT_SECONDS: Record<string, number> = {\n  h: 3600,\n  hr: 3600,\n  hrs: 3600,\n  hour: 3600,\n  hours: 3600,\n  m: 60,\n  min: 60,\n  mins: 60,\n  minute: 60,\n  minutes: 60,\n  s: 1,\n  sec: 1,\n  secs: 1,\n  second: 1,\n  seconds: 1,\n  ms: 0.001,\n};\n\nconst CLOCK = /^(?:(\\d+):)?(\\d{1,2}):(\\d{1,2}(?:\\.\\d+)?)$/u;\nconst UNIT_TOKEN = /(\\d+(?:\\.\\d+)?)\\s*([a-z]+)/giu;\n\n/**\n * Parse a duration or offset into seconds.\n *\n * Accepted: `90`, `90s`, `5m`, `1h30m`, `1h 30m 15s`, `00:30:00`, `30:00`, `250ms`.\n *\n * `allowNegative` is for the two options that name a position rather than a length.\n *\n * A recording is timed from its first record's timekeeping annotation, and nothing obliges that\n * to sit at or after zero: a file whose records run from -100 s to -97 s is one this tool reads,\n * times from -100, and describes with\n *\n *     Timed from -100.000s  (first sample; --start and --end use this clock)\n *\n * That line says the number can be typed straight back in, and it could not be. Every offset\n * such a recording has came back as \"not a time I understand\", so its whole clock was\n * unreachable and no window of it could be converted at all — the one file shape where a\n * window is refused for naming a moment the recording actually contains.\n *\n * A length below zero is still a different thing, and `--duration` still refuses one.\n */\nexport function parseTimeSpec(input: string, optionName?: string, allowNegative = false): number {\n  /*\n    A name for the value, when the caller has not given one.\n\n    Every refusal below opens with it, and the CLI passes the flag — `--start \"1,5\" is not a\n    time I understand`. This is also the function the api page sends other people's users to,\n    and a caller who writes the one-argument call its neighbours take got\n\n        TimeRangeError: undefined is empty. Try a value like 30s, 5m, or 00:30:00.\n\n    on every one of the eleven messages in here. The paragraph below hardened `input` for\n    exactly that caller; the argument beside it could still put the word `undefined` at the\n    front of the sentence.\n\n    Coerced rather than refused, unlike `input`: this one names the value in a message rather\n    than being the value, so there is a right answer to fall back on and nothing is lost by\n    using it. An empty or non-string name takes the same route, since `\"\" is empty.` is the\n    same sentence with a different hole in it.\n  */\n  const named =\n    typeof optionName === 'string' && optionName.trim() !== '' ? optionName : 'The value';\n  /*\n    Text, because this is the function the API page points other people's users at: \"Use\n    `parseTimeSpec` if you want to accept those forms from your own users.\"\n\n    A value arriving from a JSON config or a form field is a number as often as a string, and\n    `{ \"start\": 30 }` came back as `TypeError: input.trim is not a function` — a variable name\n    from inside this file, thrown past a caller who had done exactly what the page told them\n    to. Every other refusal here is a TimeRangeError quoting the value and the option. The\n    number is not coerced, for the reason `channels: 'ECG'` is not iterated: a shape that\n    happens to work for 30 also swallows NaN, and the CLI already writes `String(raw)`.\n  */\n  if (typeof input !== 'string') {\n    throw new TimeRangeError(\n      `${named} must be given as text, not ${describeValue(input)}. ` +\n        `Seconds are written \"30\", and the other forms are \"30s\", \"5m\", \"1h30m\", \"00:30:00\".`,\n    );\n  }\n  const trimmed = input.trim().toLowerCase();\n  if (trimmed === '') {\n    throw new TimeRangeError(`${named} is empty. Try a value like 30s, 5m, or 00:30:00.`);\n  }\n\n  /*\n    The sign is read off the front and applied to the whole value, so `-1h30m` is an hour and a\n    half before the origin rather than an hour before it and half an hour after.\n\n    Nothing may sit between the sign and the number, and a leading `+` is still refused: every\n    other number this tool takes is refused when written in a form nobody types, and `+5` is\n    exactly what `--decimals` and `--jobs` reject one flag over.\n  */\n  const negative = trimmed.startsWith('-');\n  const text = negative ? trimmed.slice(1) : trimmed;\n\n  /*\n    A leading plus, named as such.\n\n    Refusing it is deliberate — see the paragraph above — but it came back as \"is not a time I\n    understand. Try 30s, 5m, 1h30m, 00:30:00, or a plain number of seconds\", which is the\n    message for input that could not be read at all. Every part of `+5s` was read: the number\n    parsed, the unit was looked up and found. The one thing wrong with it is a character the\n    reader put there on purpose, and they were sent to re-check their unit spellings with `5m`\n    sitting in the list of suggestions, differing from what they typed by the sign they cannot\n    see is the problem. 0.7.102 made this argument about a space; this is the same sentence\n    about the other character that reaches it. `--decimals` and `--jobs` both quote the value\n    back and say what is wrong with it.\n\n    Every plus, not the first one, and the leftover space with it — the same rule the spaced\n    refusal below applies to spaces, for the same reason: a hint whose command this function\n    refuses is worse than no hint. `+1h+30m` was answered with `1h+30m`, which comes straight\n    back as \"is not a time I understand\", and `+ 5s` with a value that opened on a space.\n  */\n  if (text.startsWith('+')) {\n    throw new TimeRangeError(\n      `${named} \"${input}\" begins with a plus. Write the number on its own: ` +\n        `${input.trim().replaceAll('+', '').trim()}`,\n    );\n  }\n  const signed = (seconds: number): number =>\n    assertFinite(negative ? -seconds : seconds, named, input, allowNegative);\n\n  // Bare number means seconds.\n  if (/^\\d+(?:\\.\\d+)?$/u.test(text)) return signed(Number(text));\n\n  // Clock form: hh:mm:ss or mm:ss.\n  const clock = CLOCK.exec(text);\n  if (clock) {\n    const hours = clock[1] === undefined ? 0 : Number(clock[1]);\n    const minutes = Number(clock[2]);\n    const seconds = Number(clock[3]);\n    if (minutes >= 60 || seconds >= 60) {\n      throw new TimeRangeError(\n        `${named} \"${input}\" has a minutes or seconds field of 60 or more.`,\n      );\n    }\n    return signed(hours * 3600 + minutes * 60 + seconds);\n  }\n\n  // Unit form: 1h30m, 1h30m 15s, 250ms. A number sits directly against its unit; see below.\n  UNIT_TOKEN.lastIndex = 0;\n  let total = 0;\n  let matched = 0;\n  let consumed = 0;\n  /** Whether any token had a space between its number and its unit. See the refusal below. */\n  let spaced = false;\n  let match: RegExpExecArray | null;\n  // Which units have already been seen, so a repeat can be rejected rather than added.\n  const seen = new Set<number>();\n  while ((match = UNIT_TOKEN.exec(text)) !== null) {\n    const amount = Number(match[1]);\n    const unit = match[2] ?? '';\n    const scale = UNIT_SECONDS[unit];\n    if (scale === undefined) {\n      throw new TimeRangeError(\n        `${named} \"${input}\" uses an unknown unit \"${unit}\". Use h, m, s or ms, ` +\n          `or their long forms: hours, minutes, seconds.`,\n      );\n    }\n\n    // \"1h1h\" is a typo, not a request for two hours. Summing repeated units silently\n    // turned a slip into a plausible window that was quietly the wrong length. Units are\n    // keyed by their scale so the aliases collapse together: \"1h30min20m\" is caught too.\n    if (seen.has(scale)) {\n      throw new TimeRangeError(\n        `${named} \"${input}\" gives the same unit twice. ` +\n          `Combine each unit once, as in 1h30m.`,\n      );\n    }\n    seen.add(scale);\n\n    total += amount * scale;\n    matched++;\n    // Counted with the whitespace taken out, so the comparison below is against the same\n    // string on both sides and a space inside a token reaches the refusal written for it\n    // rather than the one about input that could not be read at all.\n    consumed += match[0].replace(/\\s+/gu, '').length;\n    if (/\\s/u.test(match[0])) spaced = true;\n  }\n\n  // Reject partially-understood input like \"5x\" or \"1h banana\".\n  if (matched === 0 || consumed !== text.replace(/\\s+/gu, '').length) {\n    throw new TimeRangeError(\n      `${named} \"${input}\" is not a time I understand. ` +\n        `Try 30s, 5m, 1h30m, 00:30:00, or a plain number of seconds.`,\n    );\n  }\n\n  /*\n    A space between a number and its unit, named as such.\n\n    `5 min` is refused on purpose — cli-reference sets the rule out, and it is what keeps\n    `1 2h` from being read as anything — but it came back as \"is not a time I understand. Try\n    30s, 5m, 1h30m, 00:30:00, or a plain number of seconds\", which is the message for input\n    that could not be read at all. Every part of `5 min` was read: the number parsed, the unit\n    was looked up in the table and found. The one thing wrong with it is a space, and the\n    reader was sent to re-check their unit spellings instead — with `5m` sitting in the list of\n    suggestions, differing from what they typed by a character they cannot see is the problem.\n\n    Only reachable now that the count above ignores whitespace; before, the length check caught\n    these first and there was nothing left to tell them apart by.\n  */\n  if (spaced) {\n    throw new TimeRangeError(\n      `${named} \"${input}\" puts a space between a number and its unit. ` +\n        `Write them together: ${input.trim().replace(/(\\d)\\s+([a-z])/giu, '$1$2')}`,\n    );\n  }\n\n  return signed(total);\n}\n\nfunction assertFinite(\n  value: number,\n  optionName: string,\n  input: string,\n  allowNegative: boolean,\n): number {\n  /*\n    Overflow answers for itself, rather than borrowing the sentence about signs.\n\n    One branch covered two rejections. `--start` with four hundred nines is a positive value\n    that `Number` returns as `Infinity`, and the answer was `is not a valid non-negative\n    time` — which names the one thing about it that is not the problem. Worse on the two\n    options this is called with `allowNegative` for: `--start` and `--end` take a sign on\n    purpose, since a recording timed from before zero has no other way to be addressed, so\n    \"non-negative\" is not their rule at all and overflow is the only way they reach here.\n  */\n  if (!Number.isFinite(value)) {\n    throw new TimeRangeError(\n      `${optionName} \"${input}\" is further from zero than a number of seconds can hold.`,\n    );\n  }\n  if (!allowNegative && value < 0) {\n    throw new TimeRangeError(`${optionName} \"${input}\" is not a valid non-negative time.`);\n  }\n  return value;\n}\n\nexport interface ResolvedRange {\n  /** Inclusive start, in seconds from the beginning of the recording. */\n  startSeconds: number;\n  /** Exclusive end, in seconds. */\n  endSeconds: number;\n  /** First data record touching the window. */\n  startRecord: number;\n  /** One past the last data record touching the window. */\n  endRecord: number;\n  /** True when the window covers the whole recording. */\n  isWholeRecording: boolean;\n  /** Earliest record start, including EDF+D timing gaps. */\n  recordingStartSeconds: number;\n  /** End of the latest record, including EDF+D timing gaps. */\n  recordingEndSeconds: number;\n}\n\n/**\n * Slack for comparisons at sample/window boundaries.\n *\n * A nanosecond is far below any real sampling interval — 20 kHz is 50 microseconds — so it\n * absorbs the arithmetic error in `recordStart + sample / rate` without reaching a\n * neighbouring sample.\n */\nexport const BOUNDARY_TOLERANCE = 1e-9;\n\n/**\n * The slack to use for a channel sampled this often.\n *\n * Never past half a sample interval, because slack that reaches the next sample stops being\n * slack — half is the most that cannot, since the nearest sample below a bound sits a whole\n * interval away from it. `Math.min` takes exactly half at rates above 500 MHz, which is where\n * this said \"never as much as half\" of a formula that returns it. A fixed nanosecond was\n * applied whatever the rate, and the format does not\n * oblige the interval to be larger than it: EDF's record duration is an 8-character field\n * that accepts `1e-9`. A recording of two 1 ns records holding ten samples each wrote ten of\n * its twenty rows — the window ends at 2e-9, the comparison asked for `time < 2e-9 - 1e-9`,\n * and the entire second record failed it. Exit 0, no warning, half the samples gone.\n */\nexport function toleranceFor(rate: number): number {\n  if (!(rate > 0) || !Number.isFinite(rate)) return BOUNDARY_TOLERANCE;\n  return Math.min(BOUNDARY_TOLERANCE, 1 / rate / 2);\n}\n\n/** Match the exact half-open boundary rules used while writing signal rows. */\nexport function sampleTimeIsInRange(\n  time: number,\n  startSeconds: number,\n  endSeconds: number,\n  tolerance: number = BOUNDARY_TOLERANCE,\n): boolean {\n  return time >= startSeconds - tolerance && time < endSeconds - tolerance;\n}\n\n/** Count samples from one record that fall inside a half-open requested window. */\nexport function countSamplesInRange(options: {\n  recordStart: number;\n  rate: number;\n  samplesPerRecord: number;\n  startSeconds: number;\n  endSeconds: number;\n}): number {\n  /*\n    A record with no place on the clock contributes no rows, which is what the conversion\n    already does with one: its sample times are non-finite, so every one of them fails the\n    range test and none is written. The arithmetic below reached `Infinity - Infinity` and\n    answered `NaN`, which `--info` then printed — \"Would write NaN rows, roughly NaN B.\" on a\n    recording that goes on to write eight. Reachable from a header: a record duration of 1e308\n    is five characters in an eight-character field, and the third record of one is past what a\n    double can hold.\n  */\n  if (!Number.isFinite(options.recordStart)) return 0;\n  const slack = toleranceFor(options.rate);\n  const lower = Math.ceil(\n    (options.startSeconds - slack - options.recordStart) * options.rate,\n  );\n  const upper = Math.ceil(\n    (options.endSeconds - slack - options.recordStart) * options.rate,\n  );\n  const first = Math.max(0, Math.min(options.samplesPerRecord, lower));\n  const last = Math.max(0, Math.min(options.samplesPerRecord, upper));\n  return Math.max(0, last - first);\n}\n\n/**\n * Whether two instants differ only by the arithmetic that produced them.\n *\n * A relative epsilon, because the gap between doubles grows with magnitude — the same shape\n * the long layout uses to decide two sample times are one instant. Well below any real sample\n * interval, and well above the rounding that two routes to one quantity produce: a recording's\n * length is `recordCount * recordDuration`, which for 6003 records of 0.1s is not the 600.3 it\n * prints as.\n */\nfunction sameInstant(a: number, b: number): boolean {\n  /*\n    A relative tolerance has nothing to be relative to at infinity.\n\n    `Math.abs(a - Infinity)` is Infinity, and so is the allowance beside it, so\n    `Infinity <= Infinity` made every instant the same instant as an infinite one. A\n    recording whose end overflows a double — three records of 1e308 seconds, which an\n    8-character record-duration field can state and a timekeeping TAL can place — was\n    therefore refused the window nobody asked for:\n\n        $ edf2csv rec.edf --info\n        error: --start 0s is at or past the end of this unknown recording.\n\n    Exit 2 for a file, naming a flag the command did not carry, quoting a length that is\n    `formatDuration`'s word for a number it will not print. `--info` is the one command that\n    would have explained the file and it is the one that could not run.\n\n    Finite or equal, which is the only reading that means anything: two infinities are the\n    same non-instant, and a real offset is not one of them.\n  */\n  if (!Number.isFinite(a) || !Number.isFinite(b)) return a === b;\n  return Math.abs(a - b) <= Math.max(Math.abs(a), Math.abs(b)) * 1e-12;\n}\n\n/**\n * Turn a requested window into both an exact time span and the record range that\n * contains it. Records are the unit the file can be read in; the exact span is what\n * decides which samples inside those records are actually written.\n */\nexport function resolveRange(options: {\n  start?: number | undefined;\n  /** The `--start` value exactly as typed, quoted back in the past-the-end error. */\n  startText?: string | undefined;\n  duration?: number | undefined;\n  /** The `--duration` value exactly as typed, quoted back in the window error. */\n  durationText?: string | undefined;\n  end?: number | undefined;\n  /** The `--end` value exactly as typed, quoted back in the window error. */\n  endText?: string | undefined;\n  recordDuration: number;\n  recordCount: number;\n  /**\n   * True start time of each data record, for discontinuous files. When absent,\n   * records are assumed to sit end to end.\n   */\n  recordStarts?: Float64Array | null | undefined;\n}): ResolvedRange {\n  /*\n    The same check `buildPlan` makes, made here too, because this is exported on its own.\n\n    `assertOptions` sits at the top of `buildPlan`, so `convert` was covered and the function\n    underneath it was not — and this one has its own signature block on the API page.\n    `resolveRange({ start: NaN, ... })` resolved: no error, no warning, and a range read back\n    as `startSeconds: null, startRecord: null`, which is the \"takes the whole recording\n    without saying so\" that comment names. `{ end: '2' }` was coerced by the arithmetic and\n    accepted; `{ start: '30' }` reached the past-the-end error and printed it with the value\n    missing — `--start s is at or past the end of this 3s recording`.\n  */\n  /*\n    The argument bag itself, before three properties are read off it.\n\n    `resolveRange(42)` read `.start` off a number, which is `undefined` rather than a throw, and\n    went on to answer with a range; `resolveRange(null)` reached the same line and came back as\n    `TypeError: Cannot read properties of null (reading 'start')`, naming a property of this\n    function's own parameter.\n  */\n  if (options === null || typeof options !== 'object') {\n    throw new OptionError(\n      `resolveRange takes one object — the recording's shape and the window asked of it — ` +\n        `got ${describeValue(options)}.`,\n    );\n  }\n  assertOptions({ start: options.start, duration: options.duration, end: options.end });\n  /*\n    And the two numbers the window is measured against, which that call does not cover.\n\n    `assertOptions` checks what was asked for; these are what it is asked of, and nothing\n    looked at them. `resolveRange({ start: 1, recordDuration: 1 })` — no `recordCount` —\n    answered `{ startSeconds: 0, endSeconds: null, startRecord: 0, endRecord: 0 }`: a window\n    over no records, handed back as a fact about a recording. `resolveRange(42)` reached the\n    same answer, since reading `.start` off a number is `undefined` rather than a throw.\n\n    The check `buildPlan` has made since 0.8.64, made here too, because this is exported on\n    its own — the same sentence the line above this one is here for.\n  */\n  assertRecordShape(options);\n\n  // For a continuous file the recording spans recordCount * recordDuration. A\n  // discontinuous one does not: a 10-second recording with a 95-second gap in the\n  // middle still ends at 105 seconds. Deriving the span from the records' real\n  // positions is what stops a requested window from being clipped back to the\n  // amount of *data* in the file and silently discarding everything past it.\n  const { earliest, latest } = span(options.recordStarts, options.recordCount, options.recordDuration);\n\n  if (options.duration !== undefined && options.end !== undefined) {\n    throw new TimeRangeError('Use either --duration or --end, not both.');\n  }\n\n  const startSeconds = options.start ?? earliest;\n\n  let endSeconds: number;\n  if (options.duration !== undefined) endSeconds = startSeconds + options.duration;\n  else if (options.end !== undefined) endSeconds = options.end;\n  else endSeconds = latest;\n\n  /*\n    At the end, allowing for the arithmetic that produced the end.\n\n    `latest` is `recordCount * recordDuration`, and with a fractional duration that is not the\n    number it prints as: 6003 records of 0.1s is 600.3000000000001, not 600.3. So `--start\n    600.3` on a recording `--info` calls \"10m 0.3s\" was accepted by a hair, converted nothing,\n    and exited 0 with a signals.csv holding its header — which is the empty conversion this\n    error exists to prevent, and which the same command on a whole-second recording is refused\n    for.\n\n    A relative epsilon, the same shape the long layout uses to decide two sample times are one\n    instant: well below any real interval, and well above the rounding that two different\n    routes to the same quantity produce.\n  */\n  if (startSeconds >= latest || sameInstant(startSeconds, latest)) {\n    /*\n      Quote what was typed. Reporting the parsed seconds meant `--start 4h` came back as\n      \"--start 14400s is at or past the end\", which reads as a value the user never gave.\n\n      In quotation marks, which the parse errors above have always used and this did not.\n      Without them the value ran into the sentence: `--start \"  5s  \"` printed as\n      `--start   5s   is at or past the end`, where the value appears to be `5s   is` and\n      the surrounding spaces — the actual reason a shell-built argument went wrong — are\n      invisible.\n    */\n    throw new TimeRangeError(\n      /*\n        The recording's length in the same words --info uses for it.\n\n        `formatSeconds` renders a bare number of seconds, so this message and the Duration\n        line disagreed about one file in one session: --info said \"6m 40s\" and the error said\n        \"400s\". On an overnight recording it read \"7950s recording\", leaving the reader to\n        divide by 3600 to find out whether their --start was reasonable — which is the one\n        question this message exists to answer. cli-reference.md has always documented it\n        humanised (\"2h 12m 30s\"), a form no input could produce.\n\n        The typed value keeps `quoted`, since that is the user's own text and should come\n        back exactly as they wrote it.\n      */\n      /*\n        `latest` is where the recording ends on its own clock, which is its length only when\n        it starts at zero. A file timed from its first record's timekeeping TAL need not: one\n        whose records run 1000s to 1003s is three seconds long, and this called it \"this\n        16m 43s recording\" — while --info two lines away said \"Duration 3s\". Where the\n        recording sits is the useful thing to say in that case, and it is the number --start\n        has to be given.\n      */\n      earliest === 0\n        ? `--start ${quoted(options.startText, startSeconds)} is at or past the end of this ` +\n          `${formatDuration(latest)} recording.`\n        : `--start ${quoted(options.startText, startSeconds)} is at or past the end of this ` +\n          `${formatDuration(latest - earliest)} recording, which runs from ` +\n          `${formatSeconds(earliest)} to ${formatSeconds(latest)}.`,\n    );\n  }\n  if (endSeconds <= startSeconds) {\n    // Quote whatever the caller actually gave, for the same reason as the error above.\n    const endShown =\n      options.end !== undefined && options.endText !== undefined\n        ? quoted(options.endText, endSeconds)\n        : formatSeconds(endSeconds);\n    const startShown = quoted(options.startText, startSeconds);\n    /*\n      Name the option that caused it, when only one of them could have.\n\n      `end = start + duration`, and a negative duration is refused before this, so a window\n      that ends where it starts and was built from `--duration` was built from a duration of\n      zero — the one value in the command that is wrong. The message named neither it nor the\n      flag:\n\n          edf2csv rec.edf --start 5s --duration 0\n          error: The requested window ends at 5s, which is not after its start at \"5s\".\n\n      Two mentions of the value that is fine, none of the one that is not, in a file whose\n      other refusals quote what was typed on the reasoning that \"`--start 4h` came back as\n      '--start 14400s is at or past the end', which reads as a value the user never gave\".\n      `--duration` had no typed text to quote because nothing passed it; it does now, like\n      its two neighbours.\n    */\n    throw new TimeRangeError(\n      options.end === undefined && options.duration !== undefined\n        ? `--duration ${quoted(options.durationText, options.duration)} is not a length of ` +\n          `time, so the window ends where it starts, at ${startShown}. Give a length above ` +\n          `zero, or leave --duration out to convert to the end.`\n        : `The requested window ends at ${endShown}, which is not after its start at ${startShown}.`,\n    );\n  }\n\n  const clampedEnd = Math.min(endSeconds, latest);\n  /*\n    Both ends of the window, clamped the same way.\n\n    The end has been clamped to the recording since these fields existed — `--end 999h` on a\n    two-hour file is documented as converting to the end, silently — and the start was left as\n    typed. So a window asked for before the recording begins was recorded as one:\n\n        edf2csv two-second.edf --out csv --start=-500\n        metadata.json  \"start_seconds\": -500, \"end_seconds\": 2\n\n    over a signals.csv whose first row is 0.000, with `records_converted` correctly `[0, 2]`.\n    output-files calls the pair \"the resolved time window\", which the end is and the start was\n    not, and a script taking `end_seconds - start_seconds` for the span converted got 502 for\n    two seconds of data.\n\n    `earliest` and not zero, because a recording is timed from its first record and need not\n    begin there: negative-origin.edf runs from -100s, and -100 is where a start before the\n    recording belongs. Nothing downstream moves — every sample sits at or after `earliest`, so\n    the row filter and the record selection answer the same for either value, and the byte\n    estimate takes a width from the smaller magnitude, which is the one the column actually\n    holds.\n\n    Not when the whole window sits before the recording, where there is no overlap to clamp\n    to and raising the start past the end would describe the request backwards: `--start 0\n    --duration 0.001` on a file beginning at 30s is an empty window, and EMPTY_WINDOW quotes\n    the bounds — \"(30.000s to 0.001s)\" says nothing a reader can act on, where the bounds as\n    asked for are what its hint is already explaining.\n  */\n  const clampedStart = clampedEnd <= earliest ? startSeconds : Math.max(startSeconds, earliest);\n  const { startRecord, endRecord } = selectRecords(options, clampedStart, clampedEnd);\n\n  return {\n    startSeconds: clampedStart,\n    endSeconds: clampedEnd,\n    startRecord,\n    endRecord,\n    /*\n      The same rounding, one field over.\n\n      `latest` is `recordCount * recordDuration`, and 6003 records of 0.1s is\n      600.3000000000001. So `--end 600.3` on a recording of exactly that length wrote every\n      sample it has — byte-identical to a bare conversion — and metadata.json recorded\n      `whole_recording: false` for it, while the bare run recorded true. One conversion, two\n      answers, on the field a pipeline reads to decide whether it has the lot.\n    */\n    isWholeRecording:\n      (startSeconds <= earliest || sameInstant(startSeconds, earliest)) &&\n      (clampedEnd >= latest || sameInstant(clampedEnd, latest)),\n    recordingStartSeconds: earliest,\n    recordingEndSeconds: latest,\n  };\n}\n\nfunction span(\n  recordStarts: Float64Array | null | undefined,\n  recordCount: number,\n  recordDuration: number,\n): { earliest: number; latest: number } {\n  if (!recordStarts || recordStarts.length === 0) {\n    return { earliest: 0, latest: recordCount * recordDuration };\n  }\n  let earliest = Infinity;\n  let latest = -Infinity;\n  for (const start of recordStarts) {\n    if (start < earliest) earliest = start;\n    if (start + recordDuration > latest) latest = start + recordDuration;\n  }\n  if (!Number.isFinite(earliest) || !Number.isFinite(latest)) {\n    return { earliest: 0, latest: recordCount * recordDuration };\n  }\n  return { earliest, latest };\n}\n\n/** Every record whose own time span overlaps the requested window. */\nfunction selectRecords(\n  options: { recordDuration: number; recordCount: number; recordStarts?: Float64Array | null | undefined },\n  startSeconds: number,\n  endSeconds: number,\n): { startRecord: number; endRecord: number } {\n  const starts = options.recordStarts;\n  if (!starts || starts.length === 0) {\n    /*\n      An empty range is `[0, 0]` here as it is below, rather than whatever the arithmetic\n      produced. Each bound was clamped on one side only — the start up to zero, the end down\n      to the record count — so a window lying entirely before the recording came back as\n      `records_converted: [0, -1]` in metadata.json, over a `endRecord` documented as \"one\n      past the last data record touching the window\". A script differencing the pair read\n      minus one record converted, and `ConversionProgress.recordsTotal` reported the same.\n\n      The discontinuous branch below has always answered `[0, 0]` for exactly this request,\n      so the two halves of one function disagreed about how to say \"none\": the same window on\n      `annotations.edf` and on `discontinuous.edf` gave `[0, -1]` and `[0, 0]`.\n    */\n    const first = Math.max(0, Math.floor(startSeconds / options.recordDuration));\n    const last = Math.min(options.recordCount, Math.ceil(endSeconds / options.recordDuration));\n    return first < last ? { startRecord: first, endRecord: last } : { startRecord: 0, endRecord: 0 };\n  }\n\n  let first = options.recordCount;\n  let last = 0;\n  for (let i = 0; i < starts.length; i++) {\n    const begin = starts[i] ?? 0;\n    if (begin + options.recordDuration > startSeconds && begin < endSeconds) {\n      if (i < first) first = i;\n      if (i + 1 > last) last = i + 1;\n    }\n  }\n  return first < last ? { startRecord: first, endRecord: last } : { startRecord: 0, endRecord: 0 };\n}\n\n/**\n * The value as the caller typed it, in quotation marks, or the parsed seconds if they gave\n * none. The marks show where the value begins and ends, which matters most for the values\n * that went wrong because of what surrounds them.\n */\nfunction quoted(text: string | undefined, seconds: number): string {\n  return text === undefined ? formatSeconds(seconds) : `\"${text}\"`;\n}\n\nfunction formatSeconds(seconds: number): string {\n  /*\n    The same 1e21 cliff, in the bounds this message hands back.\n\n    `--start \"9e21\"` was answered with \"is at or past the end of this 3e+21s recording, which\n    runs from 1e+21s to 4e+21s\" — a sentence whose whole purpose is to say what window there\n    is to ask for, ending in two tokens the parser refuses: `--start 1e+21s` is \"uses an\n    unknown unit \\\"e\\\"\". `Number(...)` was here to drop the trailing zeros, and it also\n    re-introduced the exponent form that `toFixed` had produced.\n  */\n  const text = fixed(seconds, 3);\n  const trimmed = text.includes('.') ? text.replace(/\\.?0+$/u, '') : text;\n  // And the same ceiling, for the same reason: this renders a bound out of the recording's own\n  // header, and a record duration of 1e308 puts 309 digits in the sentence. See `withinLine`.\n  return `${withinLine(trimmed, seconds)}s`;\n}\n"]}
+{"version":3,"file":"time-range.js","sourceRoot":"","sources":["../../src/convert/time-range.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Parsing for the time-range options.\n *\n * Researchers write offsets in whatever form is natural for the recording in front\n * of them: seconds for a short ECG strip, `30m` into a sleep study, `01:23:45` when\n * reading off a clock. All three are accepted; anything ambiguous is rejected with\n * a message that shows the forms that work.\n */\n\nimport { fixed, formatDuration, withinLine } from '../format/number.js';\nimport { assertOptions, assertRecordShape, describeValue, OptionError } from './options.js';\n\nexport class TimeRangeError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = 'TimeRangeError';\n  }\n}\n\n/**\n * Every spelling of a unit this accepts, and what one of it is worth in seconds.\n *\n * Exported so the spellings can be enumerated by a test rather than listed a second time:\n * twelve of these sixteen are named nowhere in the tool or its documentation, and none of\n * their values was checked by anything. `hrs: 360` would have converted `--start 2hrs` from\n * twelve minutes in and said nothing, which is the one kind of mistake a window may not make.\n */\nexport const UNIT_SECONDS: Record<string, number> = {\n  h: 3600,\n  hr: 3600,\n  hrs: 3600,\n  hour: 3600,\n  hours: 3600,\n  m: 60,\n  min: 60,\n  mins: 60,\n  minute: 60,\n  minutes: 60,\n  s: 1,\n  sec: 1,\n  secs: 1,\n  second: 1,\n  seconds: 1,\n  ms: 0.001,\n};\n\nconst CLOCK = /^(?:(\\d+):)?(\\d{1,2}):(\\d{1,2}(?:\\.\\d+)?)$/u;\nconst UNIT_TOKEN = /(\\d+(?:\\.\\d+)?)\\s*([a-z]+)/giu;\n\n/**\n * Parse a duration or offset into seconds.\n *\n * Accepted: `90`, `90s`, `5m`, `1h30m`, `1h 30m 15s`, `00:30:00`, `30:00`, `250ms`.\n *\n * `allowNegative` is for the two options that name a position rather than a length.\n *\n * A recording is timed from its first record's timekeeping annotation, and nothing obliges that\n * to sit at or after zero: a file whose records run from -100 s to -97 s is one this tool reads,\n * times from -100, and describes with\n *\n *     Timed from -100.000s  (first sample; --start and --end use this clock)\n *\n * That line says the number can be typed straight back in, and it could not be. Every offset\n * such a recording has came back as \"not a time I understand\", so its whole clock was\n * unreachable and no window of it could be converted at all — the one file shape where a\n * window is refused for naming a moment the recording actually contains.\n *\n * A length below zero is still a different thing, and `--duration` still refuses one.\n */\nexport function parseTimeSpec(input: string, optionName?: string, allowNegative = false): number {\n  /*\n    A name for the value, when the caller has not given one.\n\n    Every refusal below opens with it, and the CLI passes the flag — `--start \"1,5\" is not a\n    time I understand`. This is also the function the api page sends other people's users to,\n    and a caller who writes the one-argument call its neighbours take got\n\n        TimeRangeError: undefined is empty. Try a value like 30s, 5m, or 00:30:00.\n\n    on every one of the eleven messages in here. The paragraph below hardened `input` for\n    exactly that caller; the argument beside it could still put the word `undefined` at the\n    front of the sentence.\n\n    Coerced rather than refused, unlike `input`: this one names the value in a message rather\n    than being the value, so there is a right answer to fall back on and nothing is lost by\n    using it. An empty or non-string name takes the same route, since `\"\" is empty.` is the\n    same sentence with a different hole in it.\n  */\n  const named =\n    typeof optionName === 'string' && optionName.trim() !== '' ? optionName : 'The value';\n  /*\n    Text, because this is the function the API page points other people's users at: \"Use\n    `parseTimeSpec` if you want to accept those forms from your own users.\"\n\n    A value arriving from a JSON config or a form field is a number as often as a string, and\n    `{ \"start\": 30 }` came back as `TypeError: input.trim is not a function` — a variable name\n    from inside this file, thrown past a caller who had done exactly what the page told them\n    to. Every other refusal here is a TimeRangeError quoting the value and the option. The\n    number is not coerced, for the reason `channels: 'ECG'` is not iterated: a shape that\n    happens to work for 30 also swallows NaN, and the CLI already writes `String(raw)`.\n  */\n  if (typeof input !== 'string') {\n    throw new TimeRangeError(\n      `${named} must be given as text, not ${describeValue(input)}. ` +\n        `Seconds are written \"30\", and the other forms are \"30s\", \"5m\", \"1h30m\", \"00:30:00\".`,\n    );\n  }\n  const trimmed = input.trim().toLowerCase();\n  if (trimmed === '') {\n    throw new TimeRangeError(`${named} is empty. Try a value like 30s, 5m, or 00:30:00.`);\n  }\n\n  /*\n    The sign is read off the front and applied to the whole value, so `-1h30m` is an hour and a\n    half before the origin rather than an hour before it and half an hour after.\n\n    Nothing may sit between the sign and the number, and a leading `+` is still refused: every\n    other number this tool takes is refused when written in a form nobody types, and `+5` is\n    exactly what `--decimals` and `--jobs` reject one flag over.\n  */\n  const negative = trimmed.startsWith('-');\n  const text = negative ? trimmed.slice(1) : trimmed;\n\n  /*\n    A leading plus, named as such.\n\n    Refusing it is deliberate — see the paragraph above — but it came back as \"is not a time I\n    understand. Try 30s, 5m, 1h30m, 00:30:00, or a plain number of seconds\", which is the\n    message for input that could not be read at all. Every part of `+5s` was read: the number\n    parsed, the unit was looked up and found. The one thing wrong with it is a character the\n    reader put there on purpose, and they were sent to re-check their unit spellings with `5m`\n    sitting in the list of suggestions, differing from what they typed by the sign they cannot\n    see is the problem. 0.7.102 made this argument about a space; this is the same sentence\n    about the other character that reaches it. `--decimals` and `--jobs` both quote the value\n    back and say what is wrong with it.\n\n    Every plus, not the first one, and the leftover space with it — the same rule the spaced\n    refusal below applies to spaces, for the same reason: a hint whose command this function\n    refuses is worse than no hint. `+1h+30m` was answered with `1h+30m`, which comes straight\n    back as \"is not a time I understand\", and `+ 5s` with a value that opened on a space.\n  */\n  if (text.startsWith('+')) {\n    throw new TimeRangeError(\n      `${named} \"${input}\" begins with a plus. Write the number on its own: ` +\n        `${input.trim().replaceAll('+', '').trim()}`,\n    );\n  }\n  const signed = (seconds: number): number =>\n    assertFinite(negative ? -seconds : seconds, named, input, allowNegative);\n\n  // Bare number means seconds.\n  if (/^\\d+(?:\\.\\d+)?$/u.test(text)) return signed(Number(text));\n\n  // Clock form: hh:mm:ss or mm:ss.\n  const clock = CLOCK.exec(text);\n  if (clock) {\n    const hours = clock[1] === undefined ? 0 : Number(clock[1]);\n    const minutes = Number(clock[2]);\n    const seconds = Number(clock[3]);\n    if (minutes >= 60 || seconds >= 60) {\n      throw new TimeRangeError(\n        `${named} \"${input}\" has a minutes or seconds field of 60 or more.`,\n      );\n    }\n    return signed(hours * 3600 + minutes * 60 + seconds);\n  }\n\n  // Unit form: 1h30m, 1h30m 15s, 250ms. A number sits directly against its unit; see below.\n  UNIT_TOKEN.lastIndex = 0;\n  let total = 0;\n  let matched = 0;\n  let consumed = 0;\n  /** Whether any token had a space between its number and its unit. See the refusal below. */\n  let spaced = false;\n  let match: RegExpExecArray | null;\n  // Which units have already been seen, so a repeat can be rejected rather than added.\n  const seen = new Set<number>();\n  while ((match = UNIT_TOKEN.exec(text)) !== null) {\n    const amount = Number(match[1]);\n    const unit = match[2] ?? '';\n    const scale = UNIT_SECONDS[unit];\n    if (scale === undefined) {\n      throw new TimeRangeError(\n        `${named} \"${input}\" uses an unknown unit \"${unit}\". Use h, m, s or ms, ` +\n          `or their long forms: hours, minutes, seconds.`,\n      );\n    }\n\n    // \"1h1h\" is a typo, not a request for two hours. Summing repeated units silently\n    // turned a slip into a plausible window that was quietly the wrong length. Units are\n    // keyed by their scale so the aliases collapse together: \"1h30min20m\" is caught too.\n    if (seen.has(scale)) {\n      throw new TimeRangeError(\n        `${named} \"${input}\" gives the same unit twice. ` +\n          `Combine each unit once, as in 1h30m.`,\n      );\n    }\n    seen.add(scale);\n\n    total += amount * scale;\n    matched++;\n    // Counted with the whitespace taken out, so the comparison below is against the same\n    // string on both sides and a space inside a token reaches the refusal written for it\n    // rather than the one about input that could not be read at all.\n    consumed += match[0].replace(/\\s+/gu, '').length;\n    if (/\\s/u.test(match[0])) spaced = true;\n  }\n\n  // Reject partially-understood input like \"5x\" or \"1h banana\".\n  if (matched === 0 || consumed !== text.replace(/\\s+/gu, '').length) {\n    throw new TimeRangeError(\n      `${named} \"${input}\" is not a time I understand. ` +\n        `Try 30s, 5m, 1h30m, 00:30:00, or a plain number of seconds.`,\n    );\n  }\n\n  /*\n    A space between a number and its unit, named as such.\n\n    `5 min` is refused on purpose — cli-reference sets the rule out, and it is what keeps\n    `1 2h` from being read as anything — but it came back as \"is not a time I understand. Try\n    30s, 5m, 1h30m, 00:30:00, or a plain number of seconds\", which is the message for input\n    that could not be read at all. Every part of `5 min` was read: the number parsed, the unit\n    was looked up in the table and found. The one thing wrong with it is a space, and the\n    reader was sent to re-check their unit spellings instead — with `5m` sitting in the list of\n    suggestions, differing from what they typed by a character they cannot see is the problem.\n\n    Only reachable now that the count above ignores whitespace; before, the length check caught\n    these first and there was nothing left to tell them apart by.\n  */\n  if (spaced) {\n    throw new TimeRangeError(\n      `${named} \"${input}\" puts a space between a number and its unit. ` +\n        `Write them together: ${input.trim().replace(/(\\d)\\s+([a-z])/giu, '$1$2')}`,\n    );\n  }\n\n  return signed(total);\n}\n\nfunction assertFinite(\n  value: number,\n  optionName: string,\n  input: string,\n  allowNegative: boolean,\n): number {\n  /*\n    Overflow answers for itself, rather than borrowing the sentence about signs.\n\n    One branch covered two rejections. `--start` with four hundred nines is a positive value\n    that `Number` returns as `Infinity`, and the answer was `is not a valid non-negative\n    time` — which names the one thing about it that is not the problem. Worse on the two\n    options this is called with `allowNegative` for: `--start` and `--end` take a sign on\n    purpose, since a recording timed from before zero has no other way to be addressed, so\n    \"non-negative\" is not their rule at all and overflow is the only way they reach here.\n  */\n  if (!Number.isFinite(value)) {\n    throw new TimeRangeError(\n      `${optionName} \"${input}\" is further from zero than a number of seconds can hold.`,\n    );\n  }\n  /*\n    Read as `=== true`, which is how every other flag in this package is read.\n\n    A truthiness test takes a value that is not a boolean as the opposite of what it says, and\n    this is exported: `parseTimeSpec` is the function the api page tells other people to point\n    their own users at, so its third argument arrives from a config file, a query string or a\n    wrapper that did not coerce, exactly as `assertOptions` describes for the six flags —\n\n        parseTimeSpec('-5s', '--duration', 'false')   // -5\n        parseTimeSpec('-5s', '--duration', 'no')      // -5\n        parseTimeSpec('-5s', '--duration', {})        // -5\n\n    — and the value it lets through is a negative length of time, which is the one thing this\n    line exists to stop. `--duration -5s` from the command line is refused, because the CLI\n    passes a real boolean.\n  */\n  if (allowNegative !== true && value < 0) {\n    throw new TimeRangeError(`${optionName} \"${input}\" is not a valid non-negative time.`);\n  }\n  return value;\n}\n\nexport interface ResolvedRange {\n  /** Inclusive start, in seconds from the beginning of the recording. */\n  startSeconds: number;\n  /** Exclusive end, in seconds. */\n  endSeconds: number;\n  /** First data record touching the window. */\n  startRecord: number;\n  /** One past the last data record touching the window. */\n  endRecord: number;\n  /** True when the window covers the whole recording. */\n  isWholeRecording: boolean;\n  /** Earliest record start, including EDF+D timing gaps. */\n  recordingStartSeconds: number;\n  /** End of the latest record, including EDF+D timing gaps. */\n  recordingEndSeconds: number;\n}\n\n/**\n * Slack for comparisons at sample/window boundaries.\n *\n * A nanosecond is far below any real sampling interval — 20 kHz is 50 microseconds — so it\n * absorbs the arithmetic error in `recordStart + sample / rate` without reaching a\n * neighbouring sample.\n */\nexport const BOUNDARY_TOLERANCE = 1e-9;\n\n/**\n * The slack to use for a channel sampled this often.\n *\n * Never past half a sample interval, because slack that reaches the next sample stops being\n * slack — half is the most that cannot, since the nearest sample below a bound sits a whole\n * interval away from it. `Math.min` takes exactly half at rates above 500 MHz, which is where\n * this said \"never as much as half\" of a formula that returns it. A fixed nanosecond was\n * applied whatever the rate, and the format does not\n * oblige the interval to be larger than it: EDF's record duration is an 8-character field\n * that accepts `1e-9`. A recording of two 1 ns records holding ten samples each wrote ten of\n * its twenty rows — the window ends at 2e-9, the comparison asked for `time < 2e-9 - 1e-9`,\n * and the entire second record failed it. Exit 0, no warning, half the samples gone.\n */\nexport function toleranceFor(rate: number): number {\n  if (!(rate > 0) || !Number.isFinite(rate)) return BOUNDARY_TOLERANCE;\n  return Math.min(BOUNDARY_TOLERANCE, 1 / rate / 2);\n}\n\n/** Match the exact half-open boundary rules used while writing signal rows. */\nexport function sampleTimeIsInRange(\n  time: number,\n  startSeconds: number,\n  endSeconds: number,\n  tolerance: number = BOUNDARY_TOLERANCE,\n): boolean {\n  return time >= startSeconds - tolerance && time < endSeconds - tolerance;\n}\n\n/** Count samples from one record that fall inside a half-open requested window. */\nexport function countSamplesInRange(options: {\n  recordStart: number;\n  rate: number;\n  samplesPerRecord: number;\n  startSeconds: number;\n  endSeconds: number;\n}): number {\n  /*\n    A record with no place on the clock contributes no rows, which is what the conversion\n    already does with one: its sample times are non-finite, so every one of them fails the\n    range test and none is written. The arithmetic below reached `Infinity - Infinity` and\n    answered `NaN`, which `--info` then printed — \"Would write NaN rows, roughly NaN B.\" on a\n    recording that goes on to write eight. Reachable from a header: a record duration of 1e308\n    is five characters in an eight-character field, and the third record of one is past what a\n    double can hold.\n  */\n  if (!Number.isFinite(options.recordStart)) return 0;\n  const slack = toleranceFor(options.rate);\n  const lower = Math.ceil(\n    (options.startSeconds - slack - options.recordStart) * options.rate,\n  );\n  const upper = Math.ceil(\n    (options.endSeconds - slack - options.recordStart) * options.rate,\n  );\n  const first = Math.max(0, Math.min(options.samplesPerRecord, lower));\n  const last = Math.max(0, Math.min(options.samplesPerRecord, upper));\n  return Math.max(0, last - first);\n}\n\n/**\n * Whether two instants differ only by the arithmetic that produced them.\n *\n * A relative epsilon, because the gap between doubles grows with magnitude — the same shape\n * the long layout uses to decide two sample times are one instant. Well below any real sample\n * interval, and well above the rounding that two routes to one quantity produce: a recording's\n * length is `recordCount * recordDuration`, which for 6003 records of 0.1s is not the 600.3 it\n * prints as.\n */\nfunction sameInstant(a: number, b: number): boolean {\n  /*\n    A relative tolerance has nothing to be relative to at infinity.\n\n    `Math.abs(a - Infinity)` is Infinity, and so is the allowance beside it, so\n    `Infinity <= Infinity` made every instant the same instant as an infinite one. A\n    recording whose end overflows a double — three records of 1e308 seconds, which an\n    8-character record-duration field can state and a timekeeping TAL can place — was\n    therefore refused the window nobody asked for:\n\n        $ edf2csv rec.edf --info\n        error: --start 0s is at or past the end of this unknown recording.\n\n    Exit 2 for a file, naming a flag the command did not carry, quoting a length that is\n    `formatDuration`'s word for a number it will not print. `--info` is the one command that\n    would have explained the file and it is the one that could not run.\n\n    Finite or equal, which is the only reading that means anything: two infinities are the\n    same non-instant, and a real offset is not one of them.\n  */\n  if (!Number.isFinite(a) || !Number.isFinite(b)) return a === b;\n  return Math.abs(a - b) <= Math.max(Math.abs(a), Math.abs(b)) * 1e-12;\n}\n\n/**\n * Turn a requested window into both an exact time span and the record range that\n * contains it. Records are the unit the file can be read in; the exact span is what\n * decides which samples inside those records are actually written.\n */\nexport function resolveRange(options: {\n  start?: number | undefined;\n  /** The `--start` value exactly as typed, quoted back in the past-the-end error. */\n  startText?: string | undefined;\n  duration?: number | undefined;\n  /** The `--duration` value exactly as typed, quoted back in the window error. */\n  durationText?: string | undefined;\n  end?: number | undefined;\n  /** The `--end` value exactly as typed, quoted back in the window error. */\n  endText?: string | undefined;\n  recordDuration: number;\n  recordCount: number;\n  /**\n   * True start time of each data record, for discontinuous files. When absent,\n   * records are assumed to sit end to end.\n   */\n  recordStarts?: Float64Array | null | undefined;\n}): ResolvedRange {\n  /*\n    The same check `buildPlan` makes, made here too, because this is exported on its own.\n\n    `assertOptions` sits at the top of `buildPlan`, so `convert` was covered and the function\n    underneath it was not — and this one has its own signature block on the API page.\n    `resolveRange({ start: NaN, ... })` resolved: no error, no warning, and a range read back\n    as `startSeconds: null, startRecord: null`, which is the \"takes the whole recording\n    without saying so\" that comment names. `{ end: '2' }` was coerced by the arithmetic and\n    accepted; `{ start: '30' }` reached the past-the-end error and printed it with the value\n    missing — `--start s is at or past the end of this 3s recording`.\n  */\n  /*\n    The argument bag itself, before three properties are read off it.\n\n    `resolveRange(42)` read `.start` off a number, which is `undefined` rather than a throw, and\n    went on to answer with a range; `resolveRange(null)` reached the same line and came back as\n    `TypeError: Cannot read properties of null (reading 'start')`, naming a property of this\n    function's own parameter.\n  */\n  if (options === null || typeof options !== 'object') {\n    throw new OptionError(\n      `resolveRange takes one object — the recording's shape and the window asked of it — ` +\n        `got ${describeValue(options)}.`,\n    );\n  }\n  assertOptions({ start: options.start, duration: options.duration, end: options.end });\n  /*\n    And the two numbers the window is measured against, which that call does not cover.\n\n    `assertOptions` checks what was asked for; these are what it is asked of, and nothing\n    looked at them. `resolveRange({ start: 1, recordDuration: 1 })` — no `recordCount` —\n    answered `{ startSeconds: 0, endSeconds: null, startRecord: 0, endRecord: 0 }`: a window\n    over no records, handed back as a fact about a recording. `resolveRange(42)` reached the\n    same answer, since reading `.start` off a number is `undefined` rather than a throw.\n\n    The check `buildPlan` has made since 0.8.64, made here too, because this is exported on\n    its own — the same sentence the line above this one is here for.\n  */\n  assertRecordShape(options);\n\n  // For a continuous file the recording spans recordCount * recordDuration. A\n  // discontinuous one does not: a 10-second recording with a 95-second gap in the\n  // middle still ends at 105 seconds. Deriving the span from the records' real\n  // positions is what stops a requested window from being clipped back to the\n  // amount of *data* in the file and silently discarding everything past it.\n  const { earliest, latest } = span(options.recordStarts, options.recordCount, options.recordDuration);\n\n  if (options.duration !== undefined && options.end !== undefined) {\n    throw new TimeRangeError('Use either --duration or --end, not both.');\n  }\n\n  const startSeconds = options.start ?? earliest;\n\n  let endSeconds: number;\n  if (options.duration !== undefined) endSeconds = startSeconds + options.duration;\n  else if (options.end !== undefined) endSeconds = options.end;\n  else endSeconds = latest;\n\n  /*\n    At the end, allowing for the arithmetic that produced the end.\n\n    `latest` is `recordCount * recordDuration`, and with a fractional duration that is not the\n    number it prints as: 6003 records of 0.1s is 600.3000000000001, not 600.3. So `--start\n    600.3` on a recording `--info` calls \"10m 0.3s\" was accepted by a hair, converted nothing,\n    and exited 0 with a signals.csv holding its header — which is the empty conversion this\n    error exists to prevent, and which the same command on a whole-second recording is refused\n    for.\n\n    A relative epsilon, the same shape the long layout uses to decide two sample times are one\n    instant: well below any real interval, and well above the rounding that two different\n    routes to the same quantity produce.\n  */\n  if (startSeconds >= latest || sameInstant(startSeconds, latest)) {\n    /*\n      Quote what was typed. Reporting the parsed seconds meant `--start 4h` came back as\n      \"--start 14400s is at or past the end\", which reads as a value the user never gave.\n\n      In quotation marks, which the parse errors above have always used and this did not.\n      Without them the value ran into the sentence: `--start \"  5s  \"` printed as\n      `--start   5s   is at or past the end`, where the value appears to be `5s   is` and\n      the surrounding spaces — the actual reason a shell-built argument went wrong — are\n      invisible.\n    */\n    throw new TimeRangeError(\n      /*\n        The recording's length in the same words --info uses for it.\n\n        `formatSeconds` renders a bare number of seconds, so this message and the Duration\n        line disagreed about one file in one session: --info said \"6m 40s\" and the error said\n        \"400s\". On an overnight recording it read \"7950s recording\", leaving the reader to\n        divide by 3600 to find out whether their --start was reasonable — which is the one\n        question this message exists to answer. cli-reference.md has always documented it\n        humanised (\"2h 12m 30s\"), a form no input could produce.\n\n        The typed value keeps `quoted`, since that is the user's own text and should come\n        back exactly as they wrote it.\n      */\n      /*\n        `latest` is where the recording ends on its own clock, which is its length only when\n        it starts at zero. A file timed from its first record's timekeeping TAL need not: one\n        whose records run 1000s to 1003s is three seconds long, and this called it \"this\n        16m 43s recording\" — while --info two lines away said \"Duration 3s\". Where the\n        recording sits is the useful thing to say in that case, and it is the number --start\n        has to be given.\n      */\n      earliest === 0\n        ? `--start ${quoted(options.startText, startSeconds)} is at or past the end of this ` +\n          `${formatDuration(latest)} recording.`\n        : `--start ${quoted(options.startText, startSeconds)} is at or past the end of this ` +\n          `${formatDuration(latest - earliest)} recording, which runs from ` +\n          `${formatSeconds(earliest)} to ${formatSeconds(latest)}.`,\n    );\n  }\n  if (endSeconds <= startSeconds) {\n    // Quote whatever the caller actually gave, for the same reason as the error above.\n    const endShown =\n      options.end !== undefined && options.endText !== undefined\n        ? quoted(options.endText, endSeconds)\n        : formatSeconds(endSeconds);\n    const startShown = quoted(options.startText, startSeconds);\n    /*\n      Name the option that caused it, when only one of them could have.\n\n      `end = start + duration`, and a negative duration is refused before this, so a window\n      that ends where it starts and was built from `--duration` was built from a duration of\n      zero — the one value in the command that is wrong. The message named neither it nor the\n      flag:\n\n          edf2csv rec.edf --start 5s --duration 0\n          error: The requested window ends at 5s, which is not after its start at \"5s\".\n\n      Two mentions of the value that is fine, none of the one that is not, in a file whose\n      other refusals quote what was typed on the reasoning that \"`--start 4h` came back as\n      '--start 14400s is at or past the end', which reads as a value the user never gave\".\n      `--duration` had no typed text to quote because nothing passed it; it does now, like\n      its two neighbours.\n    */\n    throw new TimeRangeError(\n      options.end === undefined && options.duration !== undefined\n        ? `--duration ${quoted(options.durationText, options.duration)} is not a length of ` +\n          `time, so the window ends where it starts, at ${startShown}. Give a length above ` +\n          `zero, or leave --duration out to convert to the end.`\n        : `The requested window ends at ${endShown}, which is not after its start at ${startShown}.`,\n    );\n  }\n\n  const clampedEnd = Math.min(endSeconds, latest);\n  /*\n    Both ends of the window, clamped the same way.\n\n    The end has been clamped to the recording since these fields existed — `--end 999h` on a\n    two-hour file is documented as converting to the end, silently — and the start was left as\n    typed. So a window asked for before the recording begins was recorded as one:\n\n        edf2csv two-second.edf --out csv --start=-500\n        metadata.json  \"start_seconds\": -500, \"end_seconds\": 2\n\n    over a signals.csv whose first row is 0.000, with `records_converted` correctly `[0, 2]`.\n    output-files calls the pair \"the resolved time window\", which the end is and the start was\n    not, and a script taking `end_seconds - start_seconds` for the span converted got 502 for\n    two seconds of data.\n\n    `earliest` and not zero, because a recording is timed from its first record and need not\n    begin there: negative-origin.edf runs from -100s, and -100 is where a start before the\n    recording belongs. Nothing downstream moves — every sample sits at or after `earliest`, so\n    the row filter and the record selection answer the same for either value, and the byte\n    estimate takes a width from the smaller magnitude, which is the one the column actually\n    holds.\n\n    Not when the whole window sits before the recording, where there is no overlap to clamp\n    to and raising the start past the end would describe the request backwards: `--start 0\n    --duration 0.001` on a file beginning at 30s is an empty window, and EMPTY_WINDOW quotes\n    the bounds — \"(30.000s to 0.001s)\" says nothing a reader can act on, where the bounds as\n    asked for are what its hint is already explaining.\n  */\n  const clampedStart = clampedEnd <= earliest ? startSeconds : Math.max(startSeconds, earliest);\n  const { startRecord, endRecord } = selectRecords(options, clampedStart, clampedEnd);\n\n  return {\n    startSeconds: clampedStart,\n    endSeconds: clampedEnd,\n    startRecord,\n    endRecord,\n    /*\n      The same rounding, one field over.\n\n      `latest` is `recordCount * recordDuration`, and 6003 records of 0.1s is\n      600.3000000000001. So `--end 600.3` on a recording of exactly that length wrote every\n      sample it has — byte-identical to a bare conversion — and metadata.json recorded\n      `whole_recording: false` for it, while the bare run recorded true. One conversion, two\n      answers, on the field a pipeline reads to decide whether it has the lot.\n    */\n    isWholeRecording:\n      (startSeconds <= earliest || sameInstant(startSeconds, earliest)) &&\n      (clampedEnd >= latest || sameInstant(clampedEnd, latest)),\n    recordingStartSeconds: earliest,\n    recordingEndSeconds: latest,\n  };\n}\n\nfunction span(\n  recordStarts: Float64Array | null | undefined,\n  recordCount: number,\n  recordDuration: number,\n): { earliest: number; latest: number } {\n  if (!recordStarts || recordStarts.length === 0) {\n    return { earliest: 0, latest: recordCount * recordDuration };\n  }\n  let earliest = Infinity;\n  let latest = -Infinity;\n  for (const start of recordStarts) {\n    if (start < earliest) earliest = start;\n    if (start + recordDuration > latest) latest = start + recordDuration;\n  }\n  if (!Number.isFinite(earliest) || !Number.isFinite(latest)) {\n    return { earliest: 0, latest: recordCount * recordDuration };\n  }\n  return { earliest, latest };\n}\n\n/** Every record whose own time span overlaps the requested window. */\nfunction selectRecords(\n  options: { recordDuration: number; recordCount: number; recordStarts?: Float64Array | null | undefined },\n  startSeconds: number,\n  endSeconds: number,\n): { startRecord: number; endRecord: number } {\n  const starts = options.recordStarts;\n  if (!starts || starts.length === 0) {\n    /*\n      An empty range is `[0, 0]` here as it is below, rather than whatever the arithmetic\n      produced. Each bound was clamped on one side only — the start up to zero, the end down\n      to the record count — so a window lying entirely before the recording came back as\n      `records_converted: [0, -1]` in metadata.json, over a `endRecord` documented as \"one\n      past the last data record touching the window\". A script differencing the pair read\n      minus one record converted, and `ConversionProgress.recordsTotal` reported the same.\n\n      The discontinuous branch below has always answered `[0, 0]` for exactly this request,\n      so the two halves of one function disagreed about how to say \"none\": the same window on\n      `annotations.edf` and on `discontinuous.edf` gave `[0, -1]` and `[0, 0]`.\n    */\n    const first = Math.max(0, Math.floor(startSeconds / options.recordDuration));\n    const last = Math.min(options.recordCount, Math.ceil(endSeconds / options.recordDuration));\n    return first < last ? { startRecord: first, endRecord: last } : { startRecord: 0, endRecord: 0 };\n  }\n\n  let first = options.recordCount;\n  let last = 0;\n  for (let i = 0; i < starts.length; i++) {\n    const begin = starts[i] ?? 0;\n    if (begin + options.recordDuration > startSeconds && begin < endSeconds) {\n      if (i < first) first = i;\n      if (i + 1 > last) last = i + 1;\n    }\n  }\n  return first < last ? { startRecord: first, endRecord: last } : { startRecord: 0, endRecord: 0 };\n}\n\n/**\n * The value as the caller typed it, in quotation marks, or the parsed seconds if they gave\n * none. The marks show where the value begins and ends, which matters most for the values\n * that went wrong because of what surrounds them.\n */\nfunction quoted(text: string | undefined, seconds: number): string {\n  return text === undefined ? formatSeconds(seconds) : `\"${text}\"`;\n}\n\nfunction formatSeconds(seconds: number): string {\n  /*\n    The same 1e21 cliff, in the bounds this message hands back.\n\n    `--start \"9e21\"` was answered with \"is at or past the end of this 3e+21s recording, which\n    runs from 1e+21s to 4e+21s\" — a sentence whose whole purpose is to say what window there\n    is to ask for, ending in two tokens the parser refuses: `--start 1e+21s` is \"uses an\n    unknown unit \\\"e\\\"\". `Number(...)` was here to drop the trailing zeros, and it also\n    re-introduced the exponent form that `toFixed` had produced.\n  */\n  const text = fixed(seconds, 3);\n  const trimmed = text.includes('.') ? text.replace(/\\.?0+$/u, '') : text;\n  // And the same ceiling, for the same reason: this renders a bound out of the recording's own\n  // header, and a record duration of 1e308 puts 309 digits in the sentence. See `withinLine`.\n  return `${withinLine(trimmed, seconds)}s`;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edf2csv",
-  "version": "0.9.11",
+  "version": "0.9.13",
   "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",