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

package/dist/batch/filename.js

@@ -0,0 +1,205 @@
+/**
+ * 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 const MAX_NAME_BYTES = 120;
+/** The extensions `runBatch` writes, which a template need not and should not give. */
+const OWN_EXTENSION = /\.(?:svg|png|pdf|eps)$/i;
+/**
+ * Whether a code point is removed outright: the C0 and C1 controls other
+ * than the whitespace ones (which become spaces), DEL, the soft hyphen, the
+ * zero width space and word joiner, the byte order mark, and every
+ * bidirectional control: the Arabic letter mark, the left-to-right and
+ * right-to-left marks, embeddings, overrides and isolates. Joiners stay,
+ * because Persian and the Indic scripts need them, and so do emoji.
+ */
+function removed(code) {
+    if (code <= 0x08 || (code >= 0x0e && code <= 0x1f))
+        return true;
+    if (code >= 0x7f && code <= 0x9f)
+        return code !== 0x85;
+    return (code === 0xad ||
+        code === 0x061c ||
+        code === 0x200b ||
+        code === 0x200e ||
+        code === 0x200f ||
+        (code >= 0x202a && code <= 0x202e) ||
+        code === 0x2060 ||
+        (code >= 0x2066 && code <= 0x2069) ||
+        code === 0xfeff);
+}
+/** The text without removed characters or unpaired surrogates, which a ZIP name cannot hold. */
+function withoutInvisible(text) {
+    let out = '';
+    for (let i = 0; i < text.length; i += 1) {
+        const code = text.charCodeAt(i);
+        if (code >= 0xd800 && code <= 0xdbff) {
+            const low = text.charCodeAt(i + 1);
+            if (low >= 0xdc00 && low <= 0xdfff) {
+                out += text.slice(i, i + 2);
+                i += 1;
+            }
+            continue;
+        }
+        if ((code >= 0xdc00 && code <= 0xdfff) || removed(code))
+            continue;
+        out += text[i];
+    }
+    return out;
+}
+/** Whitespace of every kind, the line and paragraph separators and NEL included, becomes one space. */
+const SPACES = /[\s\u0085]+/g;
+/** What Windows reserves in a name, and the path separators everywhere. */
+const RESERVED_CHARACTERS = /[<>:"/\\|?*]/g;
+/** Windows device names, matched against the part of a name before its first dot. */
+const DEVICE = /^(?:con|prn|aux|nul|conin\$|conout\$|com[0-9\u00b9\u00b2\u00b3]|lpt[0-9\u00b9\u00b2\u00b3])$/i;
+function utf8Length(text) {
+    let bytes = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0);
+        bytes += code < 0x80 ? 1 : code < 0x800 ? 2 : code < 0x10000 ? 3 : 4;
+    }
+    return bytes;
+}
+/** The longest prefix of whole characters within `max` bytes of UTF-8. */
+function truncate(text, max) {
+    if (utf8Length(text) <= max)
+        return text;
+    let out = '';
+    let bytes = 0;
+    for (const char of text) {
+        const code = char.codePointAt(0);
+        const size = code < 0x80 ? 1 : code < 0x800 ? 2 : code < 0x10000 ? 3 : 4;
+        if (bytes + size > max)
+            break;
+        out += char;
+        bytes += size;
+    }
+    return out;
+}
+/** Leading dots, hyphens and spaces, and trailing ones with this layer's own extensions. */
+function trimEnds(text) {
+    let out = text;
+    for (;;) {
+        const next = out
+            .replace(OWN_EXTENSION, '')
+            .replace(/^[ .-]+/, '')
+            .replace(/[ .-]+$/, '');
+        if (next === out)
+            return out;
+        out = next;
+    }
+}
+function isDevice(name) {
+    const dot = name.indexOf('.');
+    return DEVICE.test((dot === -1 ? name : name.slice(0, dot)).trim());
+}
+/** One pass of every rule. */
+function clean(text, max) {
+    let out = withoutInvisible(text.normalize('NFC'))
+        .replace(SPACES, ' ')
+        .replace(RESERVED_CHARACTERS, '-')
+        .replace(/-{2,}/g, '-')
+        .replace(/\.{2,}/g, '.');
+    out = trimEnds(out);
+    if (isDevice(out))
+        out = `_${out}`;
+    return trimEnds(truncate(out, max));
+}
+/**
+ * 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 function sanitiseFilename(text, max = MAX_NAME_BYTES) {
+    if (typeof text !== 'string')
+        throw new TypeError('sanitiseFilename: text is a string.');
+    if (!Number.isInteger(max) || max < 8 || max > 200) {
+        throw new TypeError('sanitiseFilename: max is a whole number of bytes from 8 to 200.');
+    }
+    let out = text;
+    // Each pass can only shorten the name or add the one underscore a device
+    // name gets, which no later pass takes away, so this settles within a few.
+    for (;;) {
+        const next = clean(out, max);
+        if (next === out)
+            return out;
+        out = next;
+    }
+}
+/** How two names are compared for being the same file: NFC already, and case-folded as macOS and Windows extract. */
+export function filenameKey(name) {
+    return name.toLowerCase();
+}
+/**
+ * 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 function uniqueFilenames(rows, max = MAX_NAME_BYTES) {
+    const wanted = rows.map((row) => (row.name === '' ? row.fallback : row.name));
+    const taken = new Set();
+    const firstOf = new Map();
+    wanted.forEach((name, index) => {
+        const key = filenameKey(name);
+        if (!firstOf.has(key))
+            firstOf.set(key, index);
+        taken.add(key);
+    });
+    // Where each name's numbering got to, so a thousand rows with one name
+    // cost a thousand tries and not half a million.
+    const next = new Map();
+    return wanted.map((name, index) => {
+        const key = filenameKey(name);
+        if (firstOf.get(key) === index)
+            return { name, number: null };
+        const numbered = (number) => {
+            const suffix = `-${number}`;
+            return sanitiseFilename(`${trimEnds(truncate(name, max - suffix.length))}${suffix}`, max);
+        };
+        let number = next.get(key) ?? 2;
+        let candidate = numbered(number);
+        while (taken.has(filenameKey(candidate))) {
+            number += 1;
+            candidate = numbered(number);
+        }
+        taken.add(filenameKey(candidate));
+        next.set(key, number + 1);
+        return { name: candidate, number };
+    });
+}
+//# sourceMappingURL=filename.js.map

package/dist/batch/filename.js.map

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

package/dist/batch/index.d.ts

@@ -0,0 +1,17 @@
+export { DEFAULT_MAX_ROWS, MAX_ROWS_LIMIT, parseCsv, sniffDelimiter } from './csv.js';
+export { CSV_FALLBACK_ENCODINGS, DEFAULT_CSV_FALLBACK, decodeCsvBytes, decodeWindows1252, isCsvFallbackEncoding, } from './text-decoding.js';
+export { EncodingUnavailableError, MalformedCsvError, TooManyRowsError, UnknownColumnError, } from './errors.js';
+export type { CsvFailure } from './errors.js';
+export { BATCH_ISSUES } from './issues.js';
+export type { BatchIssueCode } from './issues.js';
+export { MAX_NAME_BYTES, sanitiseFilename, uniqueFilenames } from './filename.js';
+export { compileTemplate, fillTemplate, findColumn, parseTemplate } from './template.js';
+export type { CompiledTemplate, TemplatePart } from './template.js';
+export { planBatch } from './plan.js';
+export { MANIFEST_NAME, batchManifest, neutraliseFormula, writeCsv } from './manifest.js';
+export type { ManifestOptions } from './manifest.js';
+export { DEFAULT_PRINT_SIZE_MM, DEFAULT_VERIFY_EVERY, DEFAULT_WIDTH_PX, MAX_SAMPLES, MAX_WIDTH_PX, SEEDS_ALL, SEEDS_SAMPLED, SMALL_BATCH, errorIssue, runBatch, } from './run.js';
+export { reportResult, scanCheckJob, scanCheckVerifier } from './verify.js';
+export type { ScanCheckGenerator } from './verify.js';
+export type { BatchMapping, BatchOutcome, BatchOutput, BatchProgress, BatchRegistries, BatchRow, BatchSheetOutput, BatchStatus, BatchVerifier, BatchVerifyMode, BatchVerifyRequest, BatchVerifyResult, BatchZipOutput, CsvDelimiter, CsvTable, CsvFallbackEncoding, DecodeCsvOptions, DecodedText, FieldSource, ParseCsvOptions, RunBatchOptions, TextEncodingName, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/batch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC1F,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,GACR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC5E,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,aAAa,EACb,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,WAAW,EACX,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,GAChB,MAAM,YAAY,CAAC"}

package/dist/batch/index.js

@@ -0,0 +1,11 @@
+export { DEFAULT_MAX_ROWS, MAX_ROWS_LIMIT, parseCsv, sniffDelimiter } from './csv.js';
+export { CSV_FALLBACK_ENCODINGS, DEFAULT_CSV_FALLBACK, decodeCsvBytes, decodeWindows1252, isCsvFallbackEncoding, } from './text-decoding.js';
+export { EncodingUnavailableError, MalformedCsvError, TooManyRowsError, UnknownColumnError, } from './errors.js';
+export { BATCH_ISSUES } from './issues.js';
+export { MAX_NAME_BYTES, sanitiseFilename, uniqueFilenames } from './filename.js';
+export { compileTemplate, fillTemplate, findColumn, parseTemplate } from './template.js';
+export { planBatch } from './plan.js';
+export { MANIFEST_NAME, batchManifest, neutraliseFormula, writeCsv } from './manifest.js';
+export { DEFAULT_PRINT_SIZE_MM, DEFAULT_VERIFY_EVERY, DEFAULT_WIDTH_PX, MAX_SAMPLES, MAX_WIDTH_PX, SEEDS_ALL, SEEDS_SAMPLED, SMALL_BATCH, errorIssue, runBatch, } from './run.js';
+export { reportResult, scanCheckJob, scanCheckVerifier } from './verify.js';
+//# sourceMappingURL=index.js.map

package/dist/batch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/batch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtF,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,wBAAwB,EACxB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GAClB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEzF,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE1F,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,GACR,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/batch/issues.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The issue codes the batch layer raises, in one place so the message
+ * catalogue and its test can be checked against them in both directions.
+ *
+ * Severity is part of the meaning. An error skips the row; a warning is
+ * written into the manifest beside a row that was still made; an info issue
+ * is for a view and is left out of the manifest, where it would repeat on
+ * every line.
+ */
+export declare const BATCH_ISSUES: {
+    /** Warning, path ['rows', i]: fewer cells than the header, padded with empty ones. */
+    readonly shortRow: "batch.csv.short-row";
+    /** Warning, path ['rows', i]: more cells than the header; the extra ones have no column to map. */
+    readonly longRow: "batch.csv.long-row";
+    /** Warning, path ['headers', i]: a header used before; a mapping finds the first. */
+    readonly duplicateHeader: "batch.csv.duplicate-header";
+    /** Warning, params { encoding }: the bytes were not UTF-8, and were read as the fallback, by its WHATWG label. */
+    readonly fallbackEncoding: "batch.csv.fallback-encoding";
+    /** Info: the bytes started with a UTF-16 byte order mark and were read as UTF-16. */
+    readonly utf16: "batch.csv.utf-16";
+    /** Warning: a UTF-16 file with an odd number of bytes; the last byte was dropped. */
+    readonly oddLength: "batch.csv.odd-length";
+    /** Warning: every mapped cell in the row is empty, so it is skipped. */
+    readonly emptyRow: "batch.issue.empty-row";
+    /** Error, path ['fields', key]: a number with a decimal comma or thousands separators, which is ambiguous. */
+    readonly numberFormat: "batch.issue.number-format";
+    /** Info: the file name template gave nothing usable, so the row number was used. */
+    readonly filenameFallback: "batch.issue.filename-fallback";
+    /** Info: characters a file name cannot hold were removed or replaced. */
+    readonly filenameCleaned: "batch.issue.filename-cleaned";
+    /** Info, params { number }: another row has the same file name, so this one is numbered. */
+    readonly filenameNumbered: "batch.issue.filename-numbered";
+    /** Warning: EPS cannot carry this design's transparency, so the row was written as a PDF. */
+    readonly epsFallback: "batch.issue.eps-fallback";
+    /** Error, params { code }: drawing the row failed for a reason this layer has no sentence for. */
+    readonly failed: "batch.issue.failed";
+    /** Warning: the scan check failed for this row. */
+    readonly checkFailed: "batch.issue.check-failed";
+    /** Info: the scan check passed with warnings. */
+    readonly checkWarned: "batch.issue.check-warned";
+    /** Warning, params { code }: the scan check could not be run for this row. */
+    readonly checkUnavailable: "batch.issue.check-unavailable";
+};
+export type BatchIssueCode = (typeof BATCH_ISSUES)[keyof typeof BATCH_ISSUES];
+//# sourceMappingURL=issues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../src/batch/issues.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,YAAY;IAExB,sFAAsF;;IAEtF,mGAAmG;;IAEnG,qFAAqF;;IAErF,kHAAkH;;IAElH,qFAAqF;;IAErF,qFAAqF;;IAIrF,wEAAwE;;IAExE,8GAA8G;;IAE9G,oFAAoF;;IAEpF,yEAAyE;;IAEzE,4FAA4F;;IAI5F,6FAA6F;;IAE7F,kGAAkG;;IAElG,mDAAmD;;IAEnD,iDAAiD;;IAEjD,8EAA8E;;CAErE,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/batch/issues.js

@@ -0,0 +1,47 @@
+/**
+ * The issue codes the batch layer raises, in one place so the message
+ * catalogue and its test can be checked against them in both directions.
+ *
+ * Severity is part of the meaning. An error skips the row; a warning is
+ * written into the manifest beside a row that was still made; an info issue
+ * is for a view and is left out of the manifest, where it would repeat on
+ * every line.
+ */
+export const BATCH_ISSUES = {
+    // Reading the file.
+    /** Warning, path ['rows', i]: fewer cells than the header, padded with empty ones. */
+    shortRow: 'batch.csv.short-row',
+    /** Warning, path ['rows', i]: more cells than the header; the extra ones have no column to map. */
+    longRow: 'batch.csv.long-row',
+    /** Warning, path ['headers', i]: a header used before; a mapping finds the first. */
+    duplicateHeader: 'batch.csv.duplicate-header',
+    /** Warning, params { encoding }: the bytes were not UTF-8, and were read as the fallback, by its WHATWG label. */
+    fallbackEncoding: 'batch.csv.fallback-encoding',
+    /** Info: the bytes started with a UTF-16 byte order mark and were read as UTF-16. */
+    utf16: 'batch.csv.utf-16',
+    /** Warning: a UTF-16 file with an odd number of bytes; the last byte was dropped. */
+    oddLength: 'batch.csv.odd-length',
+    // Making each row's content.
+    /** Warning: every mapped cell in the row is empty, so it is skipped. */
+    emptyRow: 'batch.issue.empty-row',
+    /** Error, path ['fields', key]: a number with a decimal comma or thousands separators, which is ambiguous. */
+    numberFormat: 'batch.issue.number-format',
+    /** Info: the file name template gave nothing usable, so the row number was used. */
+    filenameFallback: 'batch.issue.filename-fallback',
+    /** Info: characters a file name cannot hold were removed or replaced. */
+    filenameCleaned: 'batch.issue.filename-cleaned',
+    /** Info, params { number }: another row has the same file name, so this one is numbered. */
+    filenameNumbered: 'batch.issue.filename-numbered',
+    // Drawing and writing each file.
+    /** Warning: EPS cannot carry this design's transparency, so the row was written as a PDF. */
+    epsFallback: 'batch.issue.eps-fallback',
+    /** Error, params { code }: drawing the row failed for a reason this layer has no sentence for. */
+    failed: 'batch.issue.failed',
+    /** Warning: the scan check failed for this row. */
+    checkFailed: 'batch.issue.check-failed',
+    /** Info: the scan check passed with warnings. */
+    checkWarned: 'batch.issue.check-warned',
+    /** Warning, params { code }: the scan check could not be run for this row. */
+    checkUnavailable: 'batch.issue.check-unavailable',
+};
+//# sourceMappingURL=issues.js.map

package/dist/batch/issues.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/batch/issues.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B,oBAAoB;IACpB,sFAAsF;IACtF,QAAQ,EAAE,qBAAqB;IAC/B,mGAAmG;IACnG,OAAO,EAAE,oBAAoB;IAC7B,qFAAqF;IACrF,eAAe,EAAE,4BAA4B;IAC7C,kHAAkH;IAClH,gBAAgB,EAAE,6BAA6B;IAC/C,qFAAqF;IACrF,KAAK,EAAE,kBAAkB;IACzB,qFAAqF;IACrF,SAAS,EAAE,sBAAsB;IAEjC,6BAA6B;IAC7B,wEAAwE;IACxE,QAAQ,EAAE,uBAAuB;IACjC,8GAA8G;IAC9G,YAAY,EAAE,2BAA2B;IACzC,oFAAoF;IACpF,gBAAgB,EAAE,+BAA+B;IACjD,yEAAyE;IACzE,eAAe,EAAE,8BAA8B;IAC/C,4FAA4F;IAC5F,gBAAgB,EAAE,+BAA+B;IAEjD,iCAAiC;IACjC,6FAA6F;IAC7F,WAAW,EAAE,0BAA0B;IACvC,kGAAkG;IAClG,MAAM,EAAE,oBAAoB;IAC5B,mDAAmD;IACnD,WAAW,EAAE,0BAA0B;IACvC,iDAAiD;IACjD,WAAW,EAAE,0BAA0B;IACvC,8EAA8E;IAC9E,gBAAgB,EAAE,+BAA+B;CACxC,CAAC"}

package/dist/batch/manifest.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The manifest: one line per row of the batch, saying what became of it.
+ *
+ * Columns, in this order: `row` (the spreadsheet row number), `file` (the
+ * entry's name in the ZIP, empty for a skipped row), `type` (the content
+ * type), `status` ('written' or 'skipped'), `check` (the scan check's
+ * verdict, empty when it did not run), `issues` (the codes of every warning
+ * and error on the row, separated by spaces), then `page` and `label` for a
+ * sheet, and `content` only when asked for.
+ *
+ * The content is left out unless the caller opts in. A manifest is the file
+ * that gets attached to an email or dropped into a shared drive to say a run
+ * went well, and the content of a batch is a customer list or a set of Wi-Fi
+ * passwords.
+ *
+ * Whatever is in it, it is opened in a spreadsheet, and a spreadsheet runs a
+ * cell that starts with `=`, `+`, `-` or `@` as a formula, so a product name
+ * of `=HYPERLINK(...)` would become a link on the person's own machine (CSV
+ * injection; OWASP lists these four, a tab and a carriage return). Every
+ * cell starting with one gets a leading apostrophe, which a spreadsheet
+ * reads as "this is text". File names need it as much as content does: they
+ * are built from the same cells.
+ *
+ * RFC 4180 throughout: commas, CRLF, a cell quoted when it holds a comma, a
+ * quote or a line break. UTF-8 with a byte order mark, without which Excel
+ * reads the file as the machine's code page and mangles every accent.
+ */
+import type { Issue } from '../core/issue.js';
+import type { BatchOutcome } from './types.js';
+export declare const MANIFEST_NAME = "manifest.csv";
+/** A cell a spreadsheet will show as text: a leading apostrophe on anything it would run as a formula. */
+export declare function neutraliseFormula(cell: string): string;
+/** Rows as RFC 4180 CSV, every cell neutralised, each line ended with CRLF. */
+export declare function writeCsv(rows: readonly (readonly string[])[]): string;
+/** The codes of a row's warnings and errors, each once, in the order they were raised. */
+export declare function manifestIssues(issues: readonly Issue[]): string;
+export interface ManifestOptions {
+    /** Each row's content by its index, for the `content` column. Without it there is no such column. */
+    readonly content?: (index: number) => string | null;
+}
+/** The manifest for a batch's outcomes, as the bytes of a UTF-8 CSV file. */
+export declare function batchManifest(outcomes: readonly BatchOutcome[], options?: ManifestOptions): Uint8Array;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/batch/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,aAAa,iBAAiB,CAAC;AAI5C,0GAA0G;AAC1G,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAMD,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,CAKrE;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,MAAM,CAO/D;AAED,MAAM,WAAW,eAAe;IAC/B,qGAAqG;IACrG,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACpD;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,SAAS,YAAY,EAAE,EACjC,OAAO,GAAE,eAAoB,GAC3B,UAAU,CA0BZ"}

package/dist/batch/manifest.js

@@ -0,0 +1,82 @@
+/**
+ * The manifest: one line per row of the batch, saying what became of it.
+ *
+ * Columns, in this order: `row` (the spreadsheet row number), `file` (the
+ * entry's name in the ZIP, empty for a skipped row), `type` (the content
+ * type), `status` ('written' or 'skipped'), `check` (the scan check's
+ * verdict, empty when it did not run), `issues` (the codes of every warning
+ * and error on the row, separated by spaces), then `page` and `label` for a
+ * sheet, and `content` only when asked for.
+ *
+ * The content is left out unless the caller opts in. A manifest is the file
+ * that gets attached to an email or dropped into a shared drive to say a run
+ * went well, and the content of a batch is a customer list or a set of Wi-Fi
+ * passwords.
+ *
+ * Whatever is in it, it is opened in a spreadsheet, and a spreadsheet runs a
+ * cell that starts with `=`, `+`, `-` or `@` as a formula, so a product name
+ * of `=HYPERLINK(...)` would become a link on the person's own machine (CSV
+ * injection; OWASP lists these four, a tab and a carriage return). Every
+ * cell starting with one gets a leading apostrophe, which a spreadsheet
+ * reads as "this is text". File names need it as much as content does: they
+ * are built from the same cells.
+ *
+ * RFC 4180 throughout: commas, CRLF, a cell quoted when it holds a comma, a
+ * quote or a line break. UTF-8 with a byte order mark, without which Excel
+ * reads the file as the machine's code page and mangles every accent.
+ */
+export const MANIFEST_NAME = 'manifest.csv';
+const FORMULA_START = /^[=+\-@\t\r]/;
+/** A cell a spreadsheet will show as text: a leading apostrophe on anything it would run as a formula. */
+export function neutraliseFormula(cell) {
+    return FORMULA_START.test(cell) ? `'${cell}` : cell;
+}
+function quote(cell) {
+    return /[",\r\n]/.test(cell) ? `"${cell.replace(/"/g, '""')}"` : cell;
+}
+/** Rows as RFC 4180 CSV, every cell neutralised, each line ended with CRLF. */
+export function writeCsv(rows) {
+    let out = '';
+    for (const row of rows)
+        out += `${row.map((cell) => quote(neutraliseFormula(cell))).join(',')}\r\n`;
+    return out;
+}
+/** The codes of a row's warnings and errors, each once, in the order they were raised. */
+export function manifestIssues(issues) {
+    const codes = [];
+    for (const found of issues) {
+        if (found.severity === 'info' || codes.includes(found.code))
+            continue;
+        codes.push(found.code);
+    }
+    return codes.join(' ');
+}
+/** The manifest for a batch's outcomes, as the bytes of a UTF-8 CSV file. */
+export function batchManifest(outcomes, options = {}) {
+    const sheet = outcomes.some((outcome) => outcome.sheet !== null);
+    const content = options.content;
+    const header = ['row', 'file', 'type', 'status', 'check', 'issues'];
+    if (sheet)
+        header.push('page', 'label');
+    if (content !== undefined)
+        header.push('content');
+    const lines = [header];
+    for (const outcome of outcomes) {
+        const line = [
+            String(outcome.rowNumber),
+            outcome.filename ?? '',
+            outcome.typeId,
+            outcome.status,
+            outcome.check ?? '',
+            manifestIssues(outcome.issues),
+        ];
+        if (sheet) {
+            line.push(outcome.sheet === null ? '' : String(outcome.sheet.page), outcome.sheet === null ? '' : String(outcome.sheet.label));
+        }
+        if (content !== undefined)
+            line.push(content(outcome.index) ?? '');
+        lines.push(line);
+    }
+    return new TextEncoder().encode(`\ufeff${writeCsv(lines)}`);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/batch/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/batch/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAKH,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC,0GAA0G;AAC1G,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACrD,CAAC;AAED,SAAS,KAAK,CAAC,IAAY;IAC1B,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ,CAAC,IAAoC;IAC5D,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,IAAI;QACrB,GAAG,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;IAC7E,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAAC,MAAwB;IACtD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QACtE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAOD,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAC5B,QAAiC,EACjC,UAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACpE,IAAI,KAAK;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,KAAK,GAAe,CAAC,MAAM,CAAC,CAAC;IACnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG;YACZ,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;YACzB,OAAO,CAAC,QAAQ,IAAI,EAAE;YACtB,OAAO,CAAC,MAAM;YACd,OAAO,CAAC,MAAM;YACd,OAAO,CAAC,KAAK,IAAI,EAAE;YACnB,cAAc,CAAC,OAAO,CAAC,MAAM,CAAC;SAC9B,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CACR,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EACxD,OAAO,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CACzD,CAAC;QACH,CAAC;QACD,IAAI,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC7D,CAAC"}

package/dist/batch/plan.d.ts

@@ -0,0 +1,33 @@
+/**
+ * From a table and a mapping to the rows a batch will make: each row's
+ * content, built and validated by its content type, and its file name.
+ *
+ * A cell is text, and a content type's fields are text, numbers, yes or no
+ * and lists, so each cell is read as its field's kind:
+ *
+ * - Text, multi-line text and secrets exactly as written, spaces and all; a
+ *   Wi-Fi password can start with a space.
+ * - Other text kinds (links, addresses, numbers to dial, dates, codes) with
+ *   the spaces round them dropped, which a spreadsheet adds and a reader
+ *   does not want. Currency, country and BIC codes in capitals; a choice
+ *   matched to its option ignoring case.
+ * - Numbers only as a plain decimal with a full stop, as CSV writes them in
+ *   English. A comma or a thousands separator is refused with its own issue
+ *   rather than guessed at: "1,250" is a thousand and a quarter in one
+ *   country and one and a quarter in the next, and this may be an amount of
+ *   money.
+ * - Yes or no from true, false, yes, no, y, n, 1, 0, on and off, in any case,
+ *   which covers what Excel, Sheets and people write.
+ * - A list (a contact card's phone numbers, an email's recipients) split at
+ *   line breaks, and also at semicolons and commas for addresses and numbers
+ *   (neither can contain one) and at spaces for links (which cannot either).
+ *
+ * An empty cell takes the field's default, as an untouched form would show
+ * it, and a field the mapping leaves out does too. Every row is then checked
+ * by the content type exactly as the form is, so a batch never makes a code
+ * the studio would refuse to.
+ */
+import type { BatchMapping, BatchRegistries, BatchRow, CsvTable } from './types.js';
+/** The rows of a batch: content and file name for each, every problem as an issue on its row. */
+export declare function planBatch(table: CsvTable, mapping: BatchMapping, registries: BatchRegistries): readonly BatchRow[];
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/batch/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAUH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAe,MAAM,YAAY,CAAC;AAuJjG,iGAAiG;AACjG,wBAAgB,SAAS,CACxB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,eAAe,GACzB,SAAS,QAAQ,EAAE,CAsFrB"}