@hexpro/qr-code-studio 0.0.0-stage → 0.1.1

package/dist/batch/csv.js

@@ -0,0 +1,327 @@
+/**
+ * Reading a spreadsheet export: RFC 4180, with what spreadsheets really
+ * write.
+ *
+ * RFC 4180 (section 2) is the grammar: cells separated by a delimiter,
+ * records by line breaks, a cell that holds a delimiter, a quote or a line
+ * break wrapped in double quotes, and a quote inside one written twice. On top
+ * of that, the things Excel, Google Sheets and Numbers do that the RFC does
+ * not mention:
+ *
+ * - A UTF-8 byte order mark at the start, which Excel writes so that it can
+ *   read its own file back. It is not part of the first header.
+ * - Line breaks of any kind: CRLF from Windows, LF from everything else, CR
+ *   alone from old Macs. Inside a quoted cell they are all read as LF, which
+ *   is what a multi-line content field takes and what Excel writes for Alt
+ *   and Enter.
+ * - A semicolon or a tab as the delimiter. Excel writes semicolons wherever
+ *   the decimal separator is a comma (most of Europe and South America), and
+ *   "Unicode text" is tab separated. 'auto' sniffs which, and honours the
+ *   `sep=;` first line Excel reads and writes as a hint.
+ * - Rows of nothing but delimiters at the end, which Excel exports for rows
+ *   that were formatted but never filled, and blank lines anywhere. Neither
+ *   is a row. A blank line still counts towards row numbers, because a
+ *   spreadsheet shows it as a row, and numbers here are the ones a person
+ *   finds their cell by.
+ * - Ragged rows. A short row is padded with empty cells and a long one cut
+ *   to the header, each with a warning rather than a refusal, because one
+ *   bad line should not stop five hundred good ones.
+ *
+ * What is refused is what cannot be read without guessing: a quoted cell
+ * that never closes, a quote in the middle of an unquoted cell, and text
+ * straight after a closing quote. A guess there shifts every later cell into
+ * the wrong column, so the file is refused with the row and column it went
+ * wrong at, and never the text of the cell.
+ */
+import { issue } from '../core/issue.js';
+import { MalformedCsvError, TooManyRowsError } from './errors.js';
+import { BATCH_ISSUES } from './issues.js';
+/** The most data rows read by default: a large print run, and a ZIP's entry count leaves room for it. */
+export const DEFAULT_MAX_ROWS = 10_000;
+/** The highest `maxRows` a caller may ask for. A ZIP holds 65,535 entries without ZIP64. */
+export const MAX_ROWS_LIMIT = 65_000;
+const QUOTE = 0x22;
+const CR = 0x0d;
+const LF = 0x0a;
+const BOM = 0xfeff;
+const DELIMITERS = [',', ';', '\t'];
+/** Records looked at to sniff the delimiter, and the most text that takes. */
+const SNIFF_RECORDS = 20;
+const SNIFF_CHARS = 65_536;
+/**
+ * Which delimiter the text uses, from up to its first 20 records.
+ *
+ * A delimiter that appears the same number of times, outside quotes, in
+ * every record is the answer; among several, the one that appears most, then
+ * tab, semicolon and comma in that order, because a tab inside text is rare
+ * and a semicolon file has commas in its numbers. When none is consistent,
+ * the one the header uses most, and a comma when the header uses none (a file
+ * with one column).
+ */
+export function sniffDelimiter(text) {
+    if (typeof text !== 'string')
+        throw new TypeError('sniffDelimiter: text is a string.');
+    return sniffFrom(text, text.charCodeAt(0) === BOM ? 1 : 0);
+}
+function sniffFrom(text, start) {
+    const end = Math.min(text.length, start + SNIFF_CHARS);
+    const counts = [];
+    let current = [0, 0, 0];
+    let inQuote = false;
+    let blank = true;
+    for (let i = start; i < end; i += 1) {
+        const c = text.charCodeAt(i);
+        if (c === QUOTE) {
+            inQuote = !inQuote;
+            blank = false;
+            continue;
+        }
+        if (inQuote)
+            continue;
+        if (c === CR || c === LF) {
+            if (c === CR && text.charCodeAt(i + 1) === LF)
+                i += 1;
+            if (!blank)
+                counts.push(current);
+            current = [0, 0, 0];
+            blank = true;
+            if (counts.length === SNIFF_RECORDS)
+                break;
+            continue;
+        }
+        blank = false;
+        const which = c === 0x2c ? 0 : c === 0x3b ? 1 : c === 0x09 ? 2 : -1;
+        if (which >= 0)
+            current[which] = current[which] + 1;
+    }
+    if (!blank) {
+        // A record cut off by the sample's end is not a fair count, unless it is
+        // the end of the file or the only record there is.
+        if ((end === text.length && !inQuote) || counts.length === 0)
+            counts.push(current);
+    }
+    if (counts.length === 0)
+        return ',';
+    let best = null;
+    let bestCount = 0;
+    // Tab, then semicolon, then comma, so an equal count goes to the earlier.
+    for (const which of [2, 1, 0]) {
+        const first = counts[0][which];
+        if (first === 0 || !counts.every((record) => record[which] === first))
+            continue;
+        if (first > bestCount) {
+            best = DELIMITERS[which];
+            bestCount = first;
+        }
+    }
+    if (best !== null)
+        return best;
+    const header = counts[0];
+    let chosen = 0;
+    for (const which of [2, 1, 0])
+        if (header[which] > header[chosen])
+            chosen = which;
+    return DELIMITERS[chosen];
+}
+/** An Excel `sep=` first line: the delimiter it names and where the data starts. */
+function sepLine(text, start) {
+    if (text.slice(start, start + 4).toLowerCase() !== 'sep=')
+        return null;
+    const delimiter = text[start + 4];
+    if (delimiter !== ',' && delimiter !== ';' && delimiter !== '\t')
+        return null;
+    const after = start + 5;
+    if (after === text.length)
+        return { delimiter, next: after };
+    const c = text.charCodeAt(after);
+    if (c === LF)
+        return { delimiter, next: after + 1 };
+    if (c === CR)
+        return { delimiter, next: text.charCodeAt(after + 1) === LF ? after + 2 : after + 1 };
+    return null;
+}
+function checkOptions(options) {
+    if (typeof options !== 'object' || options === null) {
+        throw new TypeError('parseCsv: options is an object.');
+    }
+    const delimiter = options.delimiter ?? 'auto';
+    if (delimiter !== 'auto' && !DELIMITERS.includes(delimiter)) {
+        throw new TypeError("parseCsv: delimiter is ',', ';', a tab or 'auto'.");
+    }
+    const max = options.maxRows ?? DEFAULT_MAX_ROWS;
+    if (!Number.isInteger(max) || max < 1 || max > MAX_ROWS_LIMIT) {
+        throw new TypeError(`parseCsv: maxRows is a whole number from 1 to ${MAX_ROWS_LIMIT}.`);
+    }
+    return { delimiter, max };
+}
+/** The folding a header is matched by when no header is exactly the name asked for. */
+export function foldHeader(name) {
+    return name.trim().toLowerCase();
+}
+/** A spreadsheet export as headers and rows. Throws 'batch/malformed-csv' and 'batch/too-many-rows'. */
+export function parseCsv(text, options = {}) {
+    if (typeof text !== 'string')
+        throw new TypeError('parseCsv: text is a string.');
+    const checked = checkOptions(options);
+    let at = text.charCodeAt(0) === BOM ? 1 : 0;
+    let line = 1;
+    const sep = sepLine(text, at);
+    if (sep !== null) {
+        at = sep.next;
+        line = 2;
+    }
+    const delimiter = checked.delimiter !== 'auto' ? checked.delimiter : (sep?.delimiter ?? sniffFrom(text, at));
+    const delim = delimiter.charCodeAt(0);
+    const n = text.length;
+    let headers = null;
+    const rows = [];
+    const rowNumbers = [];
+    const issues = [];
+    // Rows of nothing but empty cells, held back until a row with something in
+    // it shows they were not the end of the file. Kept as their row numbers
+    // only: every cell in them is empty.
+    const pending = [];
+    let record = 0;
+    const accept = (cells, rowNumber, empty) => {
+        const width = headers.length;
+        const index = rows.length;
+        if (empty) {
+            cells = new Array(width).fill('');
+        }
+        else if (cells.length < width) {
+            issues.push(issue(BATCH_ISSUES.shortRow, ['rows', index], 'warning', {
+                row: rowNumber,
+                cells: cells.length,
+                expected: width,
+            }));
+            while (cells.length < width)
+                cells.push('');
+        }
+        else if (cells.length > width) {
+            if (cells.slice(width).some((cell) => cell !== '')) {
+                issues.push(issue(BATCH_ISSUES.longRow, ['rows', index], 'warning', {
+                    row: rowNumber,
+                    cells: cells.length,
+                    expected: width,
+                }));
+            }
+            cells.length = width;
+        }
+        rows.push(Object.freeze(cells));
+        rowNumbers.push(rowNumber);
+        if (rows.length > checked.max)
+            throw new TooManyRowsError(checked.max);
+    };
+    while (at < n) {
+        const first = text.charCodeAt(at);
+        if (first === LF || first === CR) {
+            // A blank line: a row in a spreadsheet's numbering, nothing here.
+            record += 1;
+            line += 1;
+            at += first === CR && text.charCodeAt(at + 1) === LF ? 2 : 1;
+            continue;
+        }
+        record += 1;
+        const cells = [];
+        for (;;) {
+            const column = cells.length + 1;
+            if (at < n && text.charCodeAt(at) === QUOTE) {
+                const opened = { row: record, column, line };
+                at += 1;
+                let value = '';
+                for (;;) {
+                    const close = text.indexOf('"', at);
+                    if (close === -1)
+                        throw new MalformedCsvError('unterminated-quote', opened);
+                    const part = text.slice(at, close);
+                    if (part.includes('\r') || part.includes('\n')) {
+                        const normal = part.replace(/\r\n?/g, '\n');
+                        for (let i = 0; i < normal.length; i += 1)
+                            if (normal.charCodeAt(i) === LF)
+                                line += 1;
+                        value += normal;
+                    }
+                    else
+                        value += part;
+                    if (text.charCodeAt(close + 1) === QUOTE) {
+                        value += '"';
+                        at = close + 2;
+                        continue;
+                    }
+                    at = close + 1;
+                    break;
+                }
+                if (at < n) {
+                    const next = text.charCodeAt(at);
+                    if (next !== delim && next !== CR && next !== LF) {
+                        throw new MalformedCsvError('text-after-quote', { row: record, column, line });
+                    }
+                }
+                cells.push(value);
+            }
+            else {
+                let end = at;
+                while (end < n) {
+                    const c = text.charCodeAt(end);
+                    if (c === delim || c === CR || c === LF)
+                        break;
+                    if (c === QUOTE)
+                        throw new MalformedCsvError('stray-quote', { row: record, column, line });
+                    end += 1;
+                }
+                cells.push(text.slice(at, end));
+                at = end;
+            }
+            if (at >= n)
+                break;
+            const c = text.charCodeAt(at);
+            if (c === delim) {
+                at += 1;
+                continue;
+            }
+            at += c === CR && text.charCodeAt(at + 1) === LF ? 2 : 1;
+            line += 1;
+            break;
+        }
+        if (headers === null) {
+            // Excel exports columns that were formatted and never named as empty
+            // headers at the end; they cannot be mapped, so they are dropped.
+            while (cells.length > 1 && cells[cells.length - 1] === '')
+                cells.pop();
+            headers = cells;
+            const seen = new Map();
+            headers.forEach((name, index) => {
+                if (name === '')
+                    return;
+                const folded = foldHeader(name);
+                if (seen.has(folded)) {
+                    issues.push(issue(BATCH_ISSUES.duplicateHeader, ['headers', index], 'warning', {
+                        column: index + 1,
+                        first: seen.get(folded) + 1,
+                    }));
+                }
+                else
+                    seen.set(folded, index);
+            });
+            continue;
+        }
+        if (cells.every((cell) => cell === '')) {
+            pending.push(record);
+            continue;
+        }
+        for (const held of pending)
+            accept([], held, true);
+        pending.length = 0;
+        accept(cells, record, false);
+    }
+    if (headers === null)
+        throw new MalformedCsvError('empty', { row: 1, column: 1, line });
+    return Object.freeze({
+        headers: Object.freeze(headers),
+        rows: Object.freeze(rows),
+        delimiter,
+        rowNumbers: Object.freeze(rowNumbers),
+        issues: Object.freeze(issues),
+    });
+}
+//# sourceMappingURL=csv.js.map

package/dist/batch/csv.js.map

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

package/dist/batch/errors.d.ts

@@ -0,0 +1,60 @@
+/**
+ * The batch layer's errors.
+ *
+ * A spreadsheet is somebody's product list, guest list or customer list, so
+ * none of these carries a cell's text, a header's text or a file name, in the
+ * message or in params. They carry where: the row and column of the problem in
+ * the numbering a spreadsheet shows (the header is row 1, the first column is
+ * column 1), and the physical line for somebody looking at the file in an
+ * editor. That is enough to find the cell and nothing more.
+ */
+import { QrStudioError } from '../core/errors.js';
+import type { CsvFallbackEncoding } from './types.js';
+/** Why a CSV file could not be read. Each is a message key under `batch.malformed-csv.`. */
+export type CsvFailure = 
+/** A quoted cell is still open at the end of the file. */
+'unterminated-quote'
+/** A quote inside a cell that does not start with one. RFC 4180 section 2.5. */
+ | 'stray-quote'
+/** Something other than a delimiter or a line break straight after a closing quote. */
+ | 'text-after-quote'
+/** No header row: the file is empty, or holds nothing but blank lines. */
+ | 'empty';
+/** A CSV file that does not follow RFC 4180 closely enough to read without guessing. */
+export declare class MalformedCsvError extends QrStudioError {
+    readonly reason: CsvFailure;
+    constructor(reason: CsvFailure, where: {
+        row: number;
+        column: number;
+        line: number;
+    });
+}
+/**
+ * This engine's `TextDecoder` cannot read the encoding a CSV was to be read
+ * in. Refused rather than read as something else, which would give the person
+ * wrong letters and no word about why. Code 'platform/unavailable', with the
+ * encoding's WHATWG label as a param.
+ */
+export declare class EncodingUnavailableError extends QrStudioError {
+    constructor(encoding: CsvFallbackEncoding);
+}
+/** More data rows than the caller allowed. Refused while reading, so a huge file costs no more than the limit. */
+export declare class TooManyRowsError extends QrStudioError {
+    constructor(max: number);
+}
+/**
+ * A mapping names a column the file does not have.
+ *
+ * The params say which part of the mapping did it (a content field, by its
+ * key, or the file name template), never the column name that was asked for:
+ * that was typed by a person and may be a word from their data.
+ */
+export declare class UnknownColumnError extends QrStudioError {
+    constructor(where: {
+        part: 'field';
+        field: string;
+    } | {
+        part: 'filename';
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/batch/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/batch/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,4FAA4F;AAC5F,MAAM,MAAM,UAAU;AACrB,0DAA0D;AACxD,oBAAoB;AACtB,gFAAgF;GAC9E,aAAa;AACf,uFAAuF;GACrF,kBAAkB;AACpB,0EAA0E;GACxE,OAAO,CAAC;AAYX,wFAAwF;AACxF,qBAAa,iBAAkB,SAAQ,aAAa;IACnD,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;gBAEhB,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CASpF;AAED;;;;;GAKG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC9C,QAAQ,EAAE,mBAAmB;CAOzC;AAED,kHAAkH;AAClH,qBAAa,gBAAiB,SAAQ,aAAa;gBACtC,GAAG,EAAE,MAAM;CAOvB;AAED;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACxC,KAAK,EAAE;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,UAAU,CAAA;KAAE;CAO1E"}

package/dist/batch/errors.js

@@ -0,0 +1,60 @@
+/**
+ * The batch layer's errors.
+ *
+ * A spreadsheet is somebody's product list, guest list or customer list, so
+ * none of these carries a cell's text, a header's text or a file name, in the
+ * message or in params. They carry where: the row and column of the problem in
+ * the numbering a spreadsheet shows (the header is row 1, the first column is
+ * column 1), and the physical line for somebody looking at the file in an
+ * editor. That is enough to find the cell and nothing more.
+ */
+import { QrStudioError } from '../core/errors.js';
+const CSV_MESSAGES = Object.freeze({
+    'unterminated-quote': 'This file has a quoted cell that never ends, so it cannot be read. Check the row it starts on.',
+    'stray-quote': 'This file has a quote mark in the middle of a cell. Save it again from your spreadsheet, or put the cell in quotes.',
+    'text-after-quote': 'This file has text straight after the end of a quoted cell. Save it again from your spreadsheet.',
+    empty: 'This file has no rows in it.',
+});
+/** A CSV file that does not follow RFC 4180 closely enough to read without guessing. */
+export class MalformedCsvError extends QrStudioError {
+    reason;
+    constructor(reason, where) {
+        super('batch/malformed-csv', CSV_MESSAGES[reason], {
+            reason,
+            row: where.row,
+            column: where.column,
+            line: where.line,
+        });
+        this.reason = reason;
+    }
+}
+/**
+ * This engine's `TextDecoder` cannot read the encoding a CSV was to be read
+ * in. Refused rather than read as something else, which would give the person
+ * wrong letters and no word about why. Code 'platform/unavailable', with the
+ * encoding's WHATWG label as a param.
+ */
+export class EncodingUnavailableError extends QrStudioError {
+    constructor(encoding) {
+        super('platform/unavailable', 'This browser cannot read text in the encoding chosen for this file. Choose another, or save the file from your spreadsheet as CSV UTF-8.', { feature: 'text-encoding', encoding });
+    }
+}
+/** More data rows than the caller allowed. Refused while reading, so a huge file costs no more than the limit. */
+export class TooManyRowsError extends QrStudioError {
+    constructor(max) {
+        super('batch/too-many-rows', 'This file has more rows than this tool makes codes for in one go. Split it into smaller files.', { max });
+    }
+}
+/**
+ * A mapping names a column the file does not have.
+ *
+ * The params say which part of the mapping did it (a content field, by its
+ * key, or the file name template), never the column name that was asked for:
+ * that was typed by a person and may be a word from their data.
+ */
+export class UnknownColumnError extends QrStudioError {
+    constructor(where) {
+        super('batch/unknown-column', 'This refers to a column the file does not have. Choose one of its columns.', where.part === 'field' ? { part: 'field', field: where.field } : { part: 'filename' });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/batch/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/batch/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAclD,MAAM,YAAY,GAAyC,MAAM,CAAC,MAAM,CAAC;IACxE,oBAAoB,EACnB,gGAAgG;IACjG,aAAa,EACZ,qHAAqH;IACtH,kBAAkB,EACjB,kGAAkG;IACnG,KAAK,EAAE,8BAA8B;CACrC,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAC1C,MAAM,CAAa;IAE5B,YAAY,MAAkB,EAAE,KAAoD;QACnF,KAAK,CAAC,qBAAqB,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE;YAClD,MAAM;YACN,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,KAAK,CAAC,IAAI;SAChB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IAC1D,YAAY,QAA6B;QACxC,KAAK,CACJ,sBAAsB,EACtB,0IAA0I,EAC1I,EAAE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,CACtC,CAAC;IACH,CAAC;CACD;AAED,kHAAkH;AAClH,MAAM,OAAO,gBAAiB,SAAQ,aAAa;IAClD,YAAY,GAAW;QACtB,KAAK,CACJ,qBAAqB,EACrB,gGAAgG,EAChG,EAAE,GAAG,EAAE,CACP,CAAC;IACH,CAAC;CACD;AAED;;;;;;GAMG;AACH,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACpD,YAAY,KAA8D;QACzE,KAAK,CACJ,sBAAsB,EACtB,4EAA4E,EAC5E,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CACrF,CAAC;IACH,CAAC;CACD"}

package/dist/batch/filename.d.ts

@@ -0,0 +1,65 @@
+/**
+ * File names for the codes in a batch, built from a person's spreadsheet.
+ *
+ * A file name template such as `label-{sku}` fills in cells somebody else
+ * typed, and the ZIP is opened on Windows, macOS and Linux by extractors of
+ * every age. So each name is cleaned until it means the same everywhere and
+ * can only land in the folder it was extracted into:
+ *
+ * - Unicode NFC, so a name typed on a Mac (which once stored decomposed
+ *   accents) and the same name typed elsewhere are one name, for duplicates
+ *   as well as for display.
+ * - No path at all: `/` and `\` and the other characters Windows reserves
+ *   (`< > : " | ? *`) become hyphens, and runs of dots become one, so no
+ *   `..` survives anywhere in a name, let alone as a folder.
+ * - No control characters, and none of the invisible ones that reorder or
+ *   hide text: "invoice", a right-to-left override (U+202E) and "gpj.exe"
+ *   display as "invoiceexe.jpg", which is why they are removed rather than
+ *   kept.
+ * - Nothing at either end that a system treats specially: a leading dot
+ *   hides a file on Unix, a leading hyphen reads as an option to a shell
+ *   command, and Windows drops trailing dots and spaces, so "a." and "a"
+ *   would be one file there.
+ * - Not one of Windows' device names (CON, PRN, AUX, NUL, COM0 to COM9, LPT0
+ *   to LPT9 and the superscript forms), with or without an extension, which
+ *   Windows will not create as files. These get a leading underscore.
+ * - At most 120 bytes of UTF-8, cut at a character boundary, leaving room
+ *   under every file system's 255 for a number and an extension.
+ * - An extension this layer adds itself is taken off the end, so a template
+ *   of `{sku}.png` does not give `ABC.png.png`.
+ *
+ * Every rule is applied until nothing changes, so cleaning a clean name gives
+ * it back unchanged: `runBatch` cleans the names it is given again, in case
+ * they did not come from `planBatch`, and must not rename anything that did.
+ */
+/** The most bytes of UTF-8 in a name before its number and extension. */
+export declare const MAX_NAME_BYTES = 120;
+/**
+ * A name safe to write into a ZIP on every system, without an extension, or
+ * '' when nothing usable is left. The same name cleaned twice is unchanged.
+ */
+export declare function sanitiseFilename(text: string, max?: number): string;
+/** How two names are compared for being the same file: NFC already, and case-folded as macOS and Windows extract. */
+export declare function filenameKey(name: string): string;
+export interface NamedRow {
+    /** The cleaned name, or '' to use the fallback. */
+    readonly name: string;
+    /** The name to use when `name` is empty: `qr-<row number>`. */
+    readonly fallback: string;
+}
+export interface UniqueName {
+    readonly name: string;
+    /** The number added to tell it from an earlier row with the same name, or null. */
+    readonly number: number | null;
+}
+/**
+ * One name per row, unique under case folding, in the order given.
+ *
+ * The first row with a name keeps it; a later row with the same one becomes
+ * `name-2`, then `name-3`, skipping any number another row already has as its
+ * own name, so a row that is really called `label-2` keeps that and the
+ * second `label` becomes `label-3`. A numbered name is cut short first if it
+ * would pass the length limit, so cleaning it again leaves it alone.
+ */
+export declare function uniqueFilenames(rows: readonly NamedRow[], max?: number): UniqueName[];
+//# sourceMappingURL=filename.d.ts.map

package/dist/batch/filename.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filename.d.ts","sourceRoot":"","sources":["../../src/batch/filename.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,yEAAyE;AACzE,eAAO,MAAM,cAAc,MAAM,CAAC;AAgHlC;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAiB,GAAG,MAAM,CAa3E;AAED,qHAAqH;AACrH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,MAAM,WAAW,QAAQ;IACxB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,EAAE,GAAG,SAAiB,GAAG,UAAU,EAAE,CA6B7F"}