edf2csv 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sarthak Tayal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,123 @@
+# edf2csv
+
+Convert an EDF, EDF+ or BDF recording to CSV with one command.
+
+```bash
+npx edf2csv recording.edf
+```
+
+That's it. You get a `recording_csv/` folder you can open in pandas, R, MATLAB, or
+Excel. Nothing is uploaded, nothing is installed permanently, and the numbers are
+not altered on the way through.
+
+Full documentation: **[edf2csv.vercel.app](https://edf2csv.vercel.app)**
+
+## What you get
+
+```text
+recording_csv/
+├── signals.csv       the data, one row per time point
+├── channels.csv      each channel's unit, sampling rate and range
+├── annotations.csv   EDF+ events            (only if the file has them)
+└── metadata.json     recording details
+```
+
+```csv
+time_s,FP1-F7,F7-T7,T7-P7
+0.000000,-17.778,39.267,-3.712
+0.003906,0.195,0.195,0.195
+```
+
+`time_s` is seconds from the start. Columns are the channel names from the file.
+
+## Check before you convert
+
+An hour of 23-channel EEG makes a 159 MB CSV with 921,600 rows, which only just
+fits inside Excel's 1,048,576-row limit. Two hours does not. `--info` shows you what
+you'd get, without writing anything:
+
+```bash
+npx edf2csv recording.edf --info
+```
+
+Want a piece instead of the whole thing:
+
+```bash
+npx edf2csv recording.edf --start 30m --duration 5m
+```
+
+## Options
+
+```text
+  -i, --info             Show what's in the file, convert nothing
+  -o, --out <dir>        Where to write it
+  -c, --channels <list>  Only these channels, e.g. "EEG Fpz-Cz,ECG"
+      --start <time>     Start here (30s, 5m, 1h30m, 00:30:00)
+      --duration <time>  How much to convert
+      --end <time>       Or stop here instead
+      --annotations-only Just the EDF+ events
+      --decimals <n>     Force a number of decimal places
+      --checksum         Put a SHA-256 of the input in metadata.json
+  -f, --force            Overwrite the output folder
+  -q, --quiet            Less output
+      --json             Machine-readable summary on stdout
+  -h, --help             Help
+```
+
+Exit codes: `0` fine, `1` couldn't read or write the file, `2` bad command.
+
+## What it won't do to your data
+
+**It won't resample.** Some EDF files mix rates: EEG at 256 Hz, temperature at
+1 Hz. Squeezing those into one table means inventing samples, so each rate gets its
+own file (`signals_256hz.csv`, `signals_1hz.csv`). A 1 Hz channel over 3 seconds
+gets 3 rows, because that's how many readings exist.
+
+For comparison, `mne.io.read_raw_edf` turns those same 3 readings into 768
+interpolated values with no warning. That's the right call for MNE, which needs one
+uniform array to run its analysis. It's the wrong call for a converter.
+
+**It won't convert units.** Microvolts stay microvolts.
+
+**It won't hide gaps.** EDF+D recordings have real breaks in time. They show up as
+a jump in `time_s` rather than being closed up.
+
+**It won't stay quiet about problems.** Truncated files, headers that contradict
+the data, duplicate channel names, calibration that can't be applied. You get told,
+in plain words, before you rely on the output.
+
+## Is it right?
+
+Values are checked against [pyEDFlib](https://github.com/holgern/pyedflib). On the
+recordings used for testing, 129,536 sample values came out **bit-for-bit
+identical**. Not close. Identical.
+
+```bash
+npm test
+```
+
+## When to use something else
+
+This is a converter. It is the right tool when you want the numbers out of an EDF
+file and into something else. It is the wrong tool for several neighbouring jobs, and
+saying so is cheaper than you finding out later.
+
+- **Analysing the signal.** Filtering, epoching, re-referencing, ICA, spectral work:
+  use [MNE-Python](https://mne.tools). It is excellent and built for exactly this.
+- **Reading EDF inside Python.** [pyEDFlib](https://github.com/holgern/pyedflib) hands
+  you arrays directly, with no CSV in the middle. edf2csv is checked against it.
+- **Writing EDF files.** This only reads them.
+- **Viewing a recording.** [EDFbrowser](https://www.teuniz.net/edfbrowser/) is a real
+  viewer and will beat a spreadsheet every time.
+- **Huge recordings you will analyse repeatedly.** CSV is a poor archival format; an
+  EDF roughly quadruples in size as text. Convert a window, or read the file directly.
+
+Use edf2csv when the destination is a spreadsheet, a colleague who does not use
+Python, a quick look at part of a recording, or a pipeline that speaks CSV.
+
+## Notes
+
+Needs Node 20+. No runtime dependencies. MIT licensed.
+
+Reads EDF, EDF+ and BDF/BDF+ (BioSemi 24-bit). No filtering, no artifact removal,
+no AI, no network calls. It reads a file and writes files.

package/dist/cli/report.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Human-readable output for the terminal.
+ *
+ * Everything here is plain text with no colour codes, so piping to a file or a log
+ * produces exactly what appeared on screen.
+ */
+import type { Diagnostic } from '../edf/errors.js';
+import type { EdfFile } from '../edf/reader.js';
+import type { ConversionPlan } from '../convert/plan.js';
+import type { ConvertResult } from '../convert/run.js';
+/** The `--info` view: what is in this recording, and what would converting it produce. */
+export declare function formatInfo(file: EdfFile, plan: ConversionPlan): string;
+/** One line per diagnostic, prefixed so warnings are greppable. */
+export declare function formatDiagnostics(diagnostics: readonly Diagnostic[]): string;
+export declare function formatSummary(result: ConvertResult): string;
+export declare function summaryJson(result: ConvertResult): string;
+//# sourceMappingURL=report.d.ts.map

package/dist/cli/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAuBvD,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,cAAc,GAAG,MAAM,CA0DtE;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAO5E;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAU3D;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAczD"}

package/dist/cli/report.js

@@ -0,0 +1,107 @@
+/**
+ * Human-readable output for the terminal.
+ *
+ * Everything here is plain text with no colour codes, so piping to a file or a log
+ * produces exactly what appeared on screen.
+ */
+import { describeFormat, formatRate, formatWallClock } from '../edf/header.js';
+import { formatBytes, formatDuration } from '../format/number.js';
+function table(rows, alignRight) {
+    if (rows.length === 0)
+        return '';
+    const width = [];
+    for (const row of rows) {
+        row.forEach((cell, i) => {
+            width[i] = Math.max(width[i] ?? 0, cell.length);
+        });
+    }
+    return rows
+        .map((row) => row
+        .map((cell, i) => {
+        const w = width[i] ?? 0;
+        return alignRight.has(i) ? cell.padStart(w) : cell.padEnd(w);
+    })
+        .join('  ')
+        .trimEnd())
+        .join('\n');
+}
+/** The `--info` view: what is in this recording, and what would converting it produce. */
+export function formatInfo(file, plan) {
+    const { header } = file;
+    const lines = [];
+    lines.push(`File       ${file.path}`);
+    lines.push(`Format     ${describeFormat(header)}`);
+    lines.push(`Recorded   ${formatWallClock(header.startDateTime)?.replace('T', ' ') ??
+        `${header.startDateRaw} ${header.startTimeRaw} (unparseable)`}`);
+    lines.push(`Duration   ${formatDuration(file.durationSeconds)}  (${file.recordCount} records of ${header.recordDuration}s)`);
+    const elapsedSpan = plan.range.recordingEndSeconds - plan.range.recordingStartSeconds;
+    if (Math.abs(elapsedSpan - file.durationSeconds) > 1e-9) {
+        lines.push(`Time span  ${formatDuration(elapsedSpan)}  (includes discontinuities)`);
+    }
+    lines.push(`Size       ${formatBytes(file.fileSize)}`);
+    if (header.patientId)
+        lines.push(`Patient    ${header.patientId}`);
+    if (header.recordingId)
+        lines.push(`Recording  ${header.recordingId}`);
+    const signals = file.dataSignals;
+    lines.push('');
+    lines.push(`Channels   ${signals.length} signal${signals.length === 1 ? '' : 's'}${file.annotationSignals.length > 0 ? ` + ${file.annotationSignals.length} annotation channel` : ''}`);
+    lines.push('');
+    const rows = [['#', 'COLUMN', 'LABEL', 'UNIT', 'RATE', 'RANGE', 'OUTPUT']];
+    const fileFor = new Map();
+    for (const group of plan.groups) {
+        for (const channel of group.channels)
+            fileFor.set(channel.signal.index, group.fileName);
+    }
+    for (const signal of signals) {
+        rows.push([
+            String(signal.index),
+            plan.columnNames.get(signal.index) ?? '',
+            signal.label,
+            signal.physicalDimension,
+            `${formatRate(signal.samplingRate)} Hz`,
+            `${signal.physicalMin} to ${signal.physicalMax}`,
+            fileFor.get(signal.index) ?? '(not selected)',
+        ]);
+    }
+    lines.push(table(rows, new Set([0])));
+    lines.push('');
+    if (plan.groups.length > 1) {
+        lines.push(`Sampling rates differ, so channels are written to ${plan.groups.length} files, one per rate. ` +
+            `No channel is resampled.`);
+    }
+    lines.push(`Would write ${plan.estimate.rows.toLocaleString('en-US')} rows, roughly ${formatBytes(plan.estimate.bytes)}.`);
+    return lines.join('\n');
+}
+/** One line per diagnostic, prefixed so warnings are greppable. */
+export function formatDiagnostics(diagnostics) {
+    return diagnostics
+        .map((d) => {
+        const head = `${d.severity === 'warning' ? 'warning' : 'note'}: ${d.message}`;
+        return d.hint ? `${head}\n         ${d.hint}` : head;
+    })
+        .join('\n');
+}
+export function formatSummary(result) {
+    const lines = [];
+    const rows = [];
+    for (const file of result.files) {
+        rows.push([`  ${file.name}`, file.rows.toLocaleString('en-US'), file.name.endsWith('.csv') ? 'rows' : '']);
+    }
+    lines.push(`Wrote ${result.outputDir}`);
+    lines.push(table(rows, new Set([1])));
+    lines.push(`Done in ${(result.elapsedMs / 1000).toFixed(1)}s.`);
+    return lines.join('\n');
+}
+export function summaryJson(result) {
+    return JSON.stringify({
+        output_dir: result.outputDir,
+        files: result.files,
+        annotations: result.annotationCount,
+        duration_seconds: result.file.durationSeconds,
+        records: result.file.recordCount,
+        elapsed_ms: result.elapsedMs,
+        warnings: result.diagnostics.map((d) => ({ code: d.code, severity: d.severity, message: d.message })),
+    }, null, 2);
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * Command-line entry point.
+ *
+ * Output discipline: anything that is the *result* of a command goes to stdout
+ * (`--info`'s channel table, `--json`'s summary). Progress, warnings and the
+ * conversion summary go to stderr, so a conversion can be run in a pipeline without
+ * its chatter contaminating the data.
+ */
+import { defaultOutputDir } from './convert/run.js';
+export declare function main(argv: readonly string[]): Promise<number>;
+export { defaultOutputDir };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAUH,OAAO,EAA4B,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAuE9E,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAqLnE;AAqCD,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/cli.js

@@ -0,0 +1,315 @@
+#!/usr/bin/env node
+/**
+ * Command-line entry point.
+ *
+ * Output discipline: anything that is the *result* of a command goes to stdout
+ * (`--info`'s channel table, `--json`'s summary). Progress, warnings and the
+ * conversion summary go to stderr, so a conversion can be run in a pipeline without
+ * its chatter contaminating the data.
+ */
+import { parseArgs } from 'node:util';
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import { realpathSync } from 'node:fs';
+import process from 'node:process';
+import { EdfError } from './edf/errors.js';
+import { EdfFile } from './edf/reader.js';
+import { buildPlan } from './convert/plan.js';
+import { ConversionError, convert, defaultOutputDir } from './convert/run.js';
+import { ChannelSelectionError } from './convert/channels.js';
+import { TimeRangeError, parseTimeSpec } from './convert/time-range.js';
+import { deriveRecordStarts } from './convert/timing.js';
+import { formatDiagnostics, formatInfo, formatSummary, summaryJson } from './cli/report.js';
+import { VERSION } from './version.js';
+const USAGE = `edf2csv ${VERSION}
+Convert EDF, EDF+ and BDF recordings to CSV
+
+Usage
+  edf2csv <recording.edf> [options]
+
+Options
+  -i, --info             Show the recording's structure and estimated output size,
+                         without converting anything
+  -o, --out <dir>        Output directory (default: <recording>_csv beside the input)
+  -c, --channels <list>  Only these channels, comma-separated. Use #N to pick a
+                         channel by position when two share a label
+      --start <time>     Begin at this offset (30s, 5m, 1h30m, 00:30:00)
+      --duration <time>  Convert this much
+      --end <time>       Stop at this offset (instead of --duration)
+      --annotations-only Write only the EDF+ annotations, no signal data
+      --decimals <n>     Fix the decimal places instead of deriving them per channel
+      --checksum         Record a SHA-256 of the input in metadata.json
+  -f, --force            Overwrite the output directory if it exists
+  -q, --quiet            Suppress the summary; warnings and errors still print
+      --json             Print a machine-readable summary to stdout
+  -h, --help             Show this help
+  -V, --version          Show the version
+
+Output
+  A directory containing signals.csv, channels.csv, metadata.json, and
+  annotations.csv when the recording carries EDF+ annotations. Channels recorded
+  at different sampling rates are written to separate files, never resampled.
+
+Examples
+  edf2csv recording.edf
+  edf2csv recording.edf --info
+  edf2csv recording.edf --channels "EEG Fpz-Cz,ECG" --out ./converted
+  edf2csv recording.edf --start 30m --duration 5m
+  edf2csv recording.edf --annotations-only
+`;
+/** A problem with how the command was invoked, as opposed to a problem with the file. */
+class OptionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OptionError';
+    }
+}
+const EXIT_OK = 0;
+const EXIT_ERROR = 1;
+const EXIT_USAGE = 2;
+/**
+ * Piping into a consumer that exits early (`| head -1`) closes our stdout, and the
+ * next write raises EPIPE. That is normal in a shell pipeline, not an error worth a
+ * stack trace, so it is swallowed while anything else still surfaces.
+ */
+function ignoreBrokenPipe(stream) {
+    stream.on('error', (error) => {
+        if (error.code === 'EPIPE') {
+            process.exitCode = 0;
+            return;
+        }
+        throw error;
+    });
+}
+export async function main(argv) {
+    ignoreBrokenPipe(process.stdout);
+    ignoreBrokenPipe(process.stderr);
+    let values;
+    let positionals;
+    try {
+        const parsed = parseArgs({
+            args: [...argv],
+            allowPositionals: true,
+            strict: true,
+            options: {
+                info: { type: 'boolean', short: 'i' },
+                out: { type: 'string', short: 'o' },
+                channels: { type: 'string', short: 'c', multiple: true },
+                start: { type: 'string' },
+                duration: { type: 'string' },
+                end: { type: 'string' },
+                'annotations-only': { type: 'boolean' },
+                decimals: { type: 'string' },
+                checksum: { type: 'boolean' },
+                force: { type: 'boolean', short: 'f' },
+                quiet: { type: 'boolean', short: 'q' },
+                json: { type: 'boolean' },
+                help: { type: 'boolean', short: 'h' },
+                version: { type: 'boolean', short: 'V' },
+            },
+        });
+        values = parsed.values;
+        positionals = parsed.positionals;
+    }
+    catch (error) {
+        process.stderr.write(`${message(error)}\n\nRun edf2csv --help to see the options.\n`);
+        return EXIT_USAGE;
+    }
+    if (values['help'] === true) {
+        process.stdout.write(USAGE);
+        return EXIT_OK;
+    }
+    if (values['version'] === true) {
+        process.stdout.write(`${VERSION}\n`);
+        return EXIT_OK;
+    }
+    if (positionals.length === 0) {
+        process.stderr.write(`No input file given.\n\n${USAGE}`);
+        return EXIT_USAGE;
+    }
+    if (positionals.length > 1) {
+        process.stderr.write(`Expected one input file but got ${positionals.length}: ${positionals.join(', ')}\n` +
+            `Convert them one at a time, or use a shell loop.\n`);
+        return EXIT_USAGE;
+    }
+    const input = positionals[0];
+    const quiet = values['quiet'] === true;
+    const asJson = values['json'] === true;
+    try {
+        const channels = splitChannels(values['channels']);
+        const start = optionalTime(values['start'], '--start');
+        const duration = optionalTime(values['duration'], '--duration');
+        const end = optionalTime(values['end'], '--end');
+        const decimals = optionalDecimals(values['decimals']);
+        if (values['info'] === true) {
+            const file = await EdfFile.open(input);
+            try {
+                const annotationData = file.annotationSignals.length > 0
+                    ? await file.readAnnotations()
+                    : { annotations: [], recordStarts: [], malformed: 0 };
+                const timing = deriveRecordStarts(file, annotationData);
+                const plan = buildPlan({
+                    signals: file.header.signals,
+                    recordDuration: file.header.recordDuration,
+                    recordCount: file.recordCount,
+                    hasAnnotationChannel: file.annotationSignals.length > 0,
+                    recordStarts: timing.starts,
+                }, {
+                    channels,
+                    start,
+                    duration,
+                    end,
+                    decimals,
+                    annotationsOnly: values['annotations-only'] === true,
+                });
+                plan.diagnostics.push(...timing.diagnostics);
+                process.stdout.write(`${formatInfo(file, plan)}\n`);
+                const diagnostics = [...file.diagnostics, ...plan.diagnostics];
+                if (diagnostics.length > 0) {
+                    process.stderr.write(`\n${formatDiagnostics(diagnostics)}\n`);
+                }
+            }
+            finally {
+                await file.close();
+            }
+            return EXIT_OK;
+        }
+        const showProgress = !quiet && !asJson && process.stderr.isTTY === true;
+        let lastTick = 0;
+        const destination = typeof values['out'] === 'string' ? values['out'] : defaultOutputDir(input);
+        /*
+          Interrupting a conversion leaves a CSV that stops mid-recording but is still
+          perfectly well-formed, so nothing about the file itself reveals that half the
+          data is missing. Saying so on the way out is the whole point of a tool that
+          claims it will not go quiet when something is wrong.
+        */
+        const onInterrupt = (signal) => {
+            if (showProgress)
+                process.stderr.write('\r\u001b[K');
+            process.stderr.write(`\ninterrupted (${signal}): the conversion stopped part way through.\n` +
+                `       Files already written to "${destination}" are incomplete and should not be used.\n`);
+            // 128 + signal number, the conventional exit status for dying to a signal.
+            process.exit(signal === 'SIGINT' ? 130 : 143);
+        };
+        process.once('SIGINT', onInterrupt);
+        process.once('SIGTERM', onInterrupt);
+        const result = await convert(input, {
+            outputDir: typeof values['out'] === 'string' ? values['out'] : undefined,
+            channels,
+            start,
+            duration,
+            end,
+            decimals,
+            annotationsOnly: values['annotations-only'] === true,
+            checksum: values['checksum'] === true,
+            force: values['force'] === true,
+            onProgress: showProgress
+                ? (progress) => {
+                    const now = Date.now();
+                    if (now - lastTick < 100)
+                        return;
+                    lastTick = now;
+                    const percent = progress.recordsTotal === 0 ? 100 : Math.floor((progress.recordsDone / progress.recordsTotal) * 100);
+                    process.stderr.write(`\r  converting… ${percent}%`);
+                }
+                : undefined,
+        });
+        process.off('SIGINT', onInterrupt);
+        process.off('SIGTERM', onInterrupt);
+        if (showProgress)
+            process.stderr.write('\r\u001b[K');
+        if (result.diagnostics.length > 0 && !asJson) {
+            process.stderr.write(`${formatDiagnostics(result.diagnostics)}\n\n`);
+        }
+        if (asJson) {
+            process.stdout.write(`${summaryJson(result)}\n`);
+        }
+        else if (!quiet) {
+            process.stderr.write(`${formatSummary(result)}\n`);
+        }
+        return EXIT_OK;
+    }
+    catch (error) {
+        if (error instanceof EdfError || error instanceof ConversionError) {
+            process.stderr.write(`error: ${error.message}\n`);
+            if (error.hint)
+                process.stderr.write(`       ${error.hint}\n`);
+            return EXIT_ERROR;
+        }
+        if (error instanceof ChannelSelectionError ||
+            error instanceof TimeRangeError ||
+            error instanceof OptionError) {
+            process.stderr.write(`error: ${error.message}\n`);
+            return EXIT_USAGE;
+        }
+        process.stderr.write(`error: ${message(error)}\n`);
+        return EXIT_ERROR;
+    }
+}
+function splitChannels(raw) {
+    if (raw === undefined)
+        return undefined;
+    const list = Array.isArray(raw) ? raw : [String(raw)];
+    const terms = list.flatMap((entry) => entry.split(',')).map((t) => t.trim()).filter((t) => t !== '');
+    // Returning undefined here would mean "no --channels given" and convert everything,
+    // which is the opposite of what someone passing an empty list is asking for.
+    if (terms.length === 0) {
+        throw new OptionError('--channels was given but lists no channel names.');
+    }
+    return terms;
+}
+function optionalTime(raw, option) {
+    if (raw === undefined)
+        return undefined;
+    return parseTimeSpec(String(raw), option);
+}
+function optionalDecimals(raw) {
+    if (raw === undefined)
+        return undefined;
+    const text = String(raw).trim();
+    // Number('') is 0, which would quietly round every physical value to a whole number.
+    if (text === '') {
+        throw new OptionError('--decimals needs a number, for example --decimals 3.');
+    }
+    const value = Number(text);
+    if (!Number.isInteger(value) || value < 0 || value > 15) {
+        throw new OptionError(`--decimals must be a whole number between 0 and 15, got "${String(raw)}".`);
+    }
+    return value;
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export { defaultOutputDir };
+/**
+ * Whether this file was executed rather than imported.
+ *
+ * npm installs a bin as a symlink (node_modules/.bin/edf2csv -> ../edf2csv/dist/cli.js),
+ * and that is the path `npx` runs. In that case process.argv[1] is the symlink while
+ * import.meta.url is already resolved to the real file, so comparing the two directly
+ * reports "imported" and the command silently does nothing. Both sides are resolved
+ * through realpath before comparing.
+ */
+function isMainModule() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    try {
+        return realpathSync(entry) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        // An unreadable or deleted entry path is not a reason to refuse to run.
+        return pathToFileURL(entry).href === import.meta.url;
+    }
+}
+const invokedDirectly = isMainModule();
+if (invokedDirectly) {
+    main(process.argv.slice(2))
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        process.stderr.write(`error: ${message(error)}\n`);
+        process.exitCode = EXIT_ERROR;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}