react-cheminfo 0.3.0 → 0.4.0

package/lib/credits/core/credits.js.map

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

package/lib/credits/core/index.d.ts

@@ -0,0 +1,3 @@
+export type { CreditEntry, CreditId } from './credits.ts';
+export { CREDITS, creditOf, credits } from './credits.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/credits/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/credits/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/lib/credits/core/index.js

@@ -0,0 +1,2 @@
+export { CREDITS, creditOf, credits } from "./credits.js";
+//# sourceMappingURL=index.js.map

package/lib/credits/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/credits/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/lib/credits/ui/CreditsList.d.ts

@@ -0,0 +1,29 @@
+import type { ReactElement } from 'react';
+import type { CreditEntry } from '../core/credits.ts';
+/** What a credits list draws. */
+export interface CreditsListProps {
+    /** The works, in the order they are listed. */
+    entries: readonly CreditEntry[];
+    /**
+     * Whether each work's licence is written after its name.
+     * @default true
+     */
+    showLicense?: boolean;
+    /**
+     * Class the list carries, in addition to `credits-list`.
+     * @default undefined
+     */
+    className?: string;
+}
+/**
+ * The Credits section of an About dialog: every borrowed work, what it does
+ * here, and under which licence.
+ *
+ * Naming the licence beside the work is what makes the list a credit rather
+ * than a list of links, and it is the part a site is most likely to leave out
+ * when it writes its own.
+ * @param props - See {@link CreditsListProps}.
+ * @returns The list.
+ */
+export declare function CreditsList(props: CreditsListProps): ReactElement;
+//# sourceMappingURL=CreditsList.d.ts.map

package/lib/credits/ui/CreditsList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreditsList.d.ts","sourceRoot":"","sources":["../../../src/credits/ui/CreditsList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CA8BjE"}

package/lib/credits/ui/CreditsList.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The Credits section of an About dialog: every borrowed work, what it does
+ * here, and under which licence.
+ *
+ * Naming the licence beside the work is what makes the list a credit rather
+ * than a list of links, and it is the part a site is most likely to leave out
+ * when it writes its own.
+ * @param props - See {@link CreditsListProps}.
+ * @returns The list.
+ */
+export function CreditsList(props) {
+    const { entries, showLicense = true, className } = props;
+    return (_jsx("ul", { className: className === undefined ? 'credits-list' : `credits-list ${className}`, style: LIST_STYLE, children: entries.map((entry) => (_jsxs("li", { style: ITEM_STYLE, children: [_jsx("a", { href: entry.href, target: "_blank", rel: "noopener noreferrer", style: NAME_STYLE, children: entry.name }), showLicense && entry.license !== undefined ? (_jsx("span", { style: LICENSE_STYLE, children: entry.license })) : (' '), _jsx("span", { children: entry.description })] }, entry.id))) }));
+}
+const LIST_STYLE = {
+    display: 'flex',
+    flexDirection: 'column',
+    gap: 4,
+    margin: 0,
+    paddingLeft: 18,
+};
+const ITEM_STYLE = {
+    fontSize: 13,
+    lineHeight: 1.4,
+};
+const NAME_STYLE = { fontWeight: 600 };
+const LICENSE_STYLE = {
+    color: '#5f6b7c',
+    fontSize: 11,
+    margin: '0 6px',
+};
+//# sourceMappingURL=CreditsList.js.map

package/lib/credits/ui/CreditsList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreditsList.js","sourceRoot":"","sources":["../../../src/credits/ui/CreditsList.tsx"],"names":[],"mappings":";AAoBA;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAEzD,OAAO,CACL,aACE,SAAS,EACP,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,SAAS,EAAE,EAExE,KAAK,EAAE,UAAU,YAEhB,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACtB,cAAmB,KAAK,EAAE,UAAU,aAClC,YACE,IAAI,EAAE,KAAK,CAAC,IAAI,EAChB,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,EACzB,KAAK,EAAE,UAAU,YAEhB,KAAK,CAAC,IAAI,GACT,EACH,WAAW,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAC5C,eAAM,KAAK,EAAE,aAAa,YAAG,KAAK,CAAC,OAAO,GAAQ,CACnD,CAAC,CAAC,CAAC,CACF,GAAG,CACJ,EACD,yBAAO,KAAK,CAAC,WAAW,GAAQ,KAdzB,KAAK,CAAC,EAAE,CAeZ,CACN,CAAC,GACC,CACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,WAAW,EAAE,EAAE;CACiB,CAAC;AAEnC,MAAM,UAAU,GAAG;IACjB,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,GAAG;CACiB,CAAC;AAEnC,MAAM,UAAU,GAAG,EAAE,UAAU,EAAE,GAAG,EAAmC,CAAC;AAExE,MAAM,aAAa,GAAG;IACpB,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,OAAO;CACiB,CAAC"}

package/lib/credits/ui/index.d.ts

@@ -0,0 +1,3 @@
+export type { CreditsListProps } from './CreditsList.tsx';
+export { CreditsList } from './CreditsList.tsx';
+//# sourceMappingURL=index.d.ts.map

package/lib/credits/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/credits/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/credits/ui/index.js

@@ -0,0 +1,2 @@
+export { CreditsList } from "./CreditsList.js";
+//# sourceMappingURL=index.js.map

package/lib/credits/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/credits/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC"}

package/lib/delimited/core/delimiters.d.ts

@@ -0,0 +1,31 @@
+/** The separators a table can be written with. */
+export type DelimiterId = 'tab' | 'comma' | 'semicolon';
+/** One separator, and everything a file written with it needs. */
+export interface DelimiterChoice {
+    /** How the choice is named in a link and in a dialog. */
+    id: DelimiterId;
+    /** What the choice reads in the interface. */
+    label: string;
+    /** The character itself. */
+    delimiter: string;
+    /** Extension a file written with it takes, without the dot. */
+    extension: string;
+    /** What such a file is, so the system opens it with a spreadsheet. */
+    mimeType: string;
+}
+/**
+ * The separator a choice stands for, whatever a link or a stored preference
+ * carries.
+ *
+ * An unknown id falls back to the tab rather than throwing: this value comes
+ * out of an address or a stored setting, and a link written two years ago must
+ * still open.
+ * @param id - The named choice.
+ * @returns The choice, or the tab one when the name is not known.
+ */
+export declare function delimiterChoice(id: string | undefined): DelimiterChoice;
+/** Every separator offered, in the order a dialog lists them. */
+export declare const DELIMITER_CHOICES: readonly DelimiterChoice[];
+/** The separator used when a caller does not name one. */
+export declare const DEFAULT_DELIMITER = "\t";
+//# sourceMappingURL=delimiters.d.ts.map

package/lib/delimited/core/delimiters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimiters.d.ts","sourceRoot":"","sources":["../../../src/delimited/core/delimiters.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,CAAC;AAExD,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,EAAE,EAAE,WAAW,CAAC;IAChB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAKvE;AAWD,iEAAiE;AACjE,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EAgBvD,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,OAAO,CAAC"}

package/lib/delimited/core/delimiters.js

@@ -0,0 +1,46 @@
+/**
+ * The separator a choice stands for, whatever a link or a stored preference
+ * carries.
+ *
+ * An unknown id falls back to the tab rather than throwing: this value comes
+ * out of an address or a stored setting, and a link written two years ago must
+ * still open.
+ * @param id - The named choice.
+ * @returns The choice, or the tab one when the name is not known.
+ */
+export function delimiterChoice(id) {
+    for (const choice of DELIMITER_CHOICES) {
+        if (choice.id === id)
+            return choice;
+    }
+    return TAB_CHOICE;
+}
+/** The tab, which is what a table is written with unless asked otherwise. */
+const TAB_CHOICE = {
+    id: 'tab',
+    label: 'Tab',
+    delimiter: '\t',
+    extension: 'tsv',
+    mimeType: 'text/tab-separated-values',
+};
+/** Every separator offered, in the order a dialog lists them. */
+export const DELIMITER_CHOICES = [
+    TAB_CHOICE,
+    {
+        id: 'comma',
+        label: 'Comma',
+        delimiter: ',',
+        extension: 'csv',
+        mimeType: 'text/csv',
+    },
+    {
+        id: 'semicolon',
+        label: 'Semicolon',
+        delimiter: ';',
+        extension: 'csv',
+        mimeType: 'text/csv',
+    },
+];
+/** The separator used when a caller does not name one. */
+export const DEFAULT_DELIMITER = '\t';
+//# sourceMappingURL=delimiters.js.map

package/lib/delimited/core/delimiters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delimiters.js","sourceRoot":"","sources":["../../../src/delimited/core/delimiters.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,EAAsB;IACpD,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;QACvC,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE;YAAE,OAAO,MAAM,CAAC;IACtC,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,GAAoB;IAClC,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,KAAK;IAChB,QAAQ,EAAE,2BAA2B;CACtC,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAA+B;IAC3D,UAAU;IACV;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,OAAO;QACd,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,UAAU;KACrB;IACD;QACE,EAAE,EAAE,WAAW;QACf,KAAK,EAAE,WAAW;QAClB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,UAAU;KACrB;CACF,CAAC;AAEF,0DAA0D;AAC1D,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC"}

package/lib/delimited/core/index.d.ts

@@ -0,0 +1,9 @@
+export type { DelimiterChoice, DelimiterId } from './delimiters.ts';
+export { DEFAULT_DELIMITER, DELIMITER_CHOICES } from './delimiters.ts';
+export type { ReadDelimitedOptions } from './readDelimited.ts';
+export { detectDelimiter, readDelimited } from './readDelimited.ts';
+export type { DelimitedColumn, RowsToDelimitedOptions, } from './rowsToDelimited.ts';
+export { rowsToDelimited } from './rowsToDelimited.ts';
+export type { ToDelimitedOptions } from './toDelimited.ts';
+export { toDelimited } from './toDelimited.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/delimited/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/delimited/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EACV,eAAe,EACf,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/delimited/core/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_DELIMITER, DELIMITER_CHOICES } from "./delimiters.js";
+export { detectDelimiter, readDelimited } from "./readDelimited.js";
+export { rowsToDelimited } from "./rowsToDelimited.js";
+export { toDelimited } from "./toDelimited.js";
+//# sourceMappingURL=index.js.map

package/lib/delimited/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/delimited/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/delimited/core/readDelimited.d.ts

@@ -0,0 +1,32 @@
+/** How a table is read back. */
+export interface ReadDelimitedOptions {
+    /**
+     * What separates two cells. Left out, the separator is guessed from the text.
+     * @default undefined — the separator is detected
+     */
+    delimiter?: string;
+}
+/**
+ * Read delimited text back into rows.
+ *
+ * Quoting is honoured, so a cell holding the separator, a newline or a doubled
+ * quote comes back as it went in. A byte-order mark is dropped, `\r\n` and `\n`
+ * both end a line, and a blank line — the trailing one included — is skipped
+ * rather than read as a row carrying one empty cell.
+ * @param text - The file, as text.
+ * @param options - See {@link ReadDelimitedOptions}.
+ * @returns The rows, each an array of cells.
+ */
+export declare function readDelimited(text: string, options?: ReadDelimitedOptions): string[][];
+/**
+ * Guess what separates the cells of a piece of delimited text.
+ *
+ * The candidates are counted outside quotes over the first few lines, so a
+ * comma inside a compound name does not win against the tabs actually
+ * separating the columns.
+ * @param text - The file, as text.
+ * @returns The separator, falling back to the tab when nothing separates
+ *   anything.
+ */
+export declare function detectDelimiter(text: string): string;
+//# sourceMappingURL=readDelimited.d.ts.map

package/lib/delimited/core/readDelimited.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readDelimited.d.ts","sourceRoot":"","sources":["../../../src/delimited/core/readDelimited.ts"],"names":[],"mappings":"AAEA,gCAAgC;AAChC,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,MAAM,EAAE,EAAE,CA4CZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWpD"}

package/lib/delimited/core/readDelimited.js

@@ -0,0 +1,122 @@
+import { DEFAULT_DELIMITER } from "./delimiters.js";
+/**
+ * Read delimited text back into rows.
+ *
+ * Quoting is honoured, so a cell holding the separator, a newline or a doubled
+ * quote comes back as it went in. A byte-order mark is dropped, `\r\n` and `\n`
+ * both end a line, and a blank line — the trailing one included — is skipped
+ * rather than read as a row carrying one empty cell.
+ * @param text - The file, as text.
+ * @param options - See {@link ReadDelimitedOptions}.
+ * @returns The rows, each an array of cells.
+ */
+export function readDelimited(text, options = {}) {
+    const content = text.codePointAt(0) === 0xfe_ff ? text.slice(1) : text;
+    if (content === '')
+        return [];
+    const delimiter = options.delimiter ?? detectDelimiter(content);
+    const rows = [];
+    let row = [];
+    let cell = '';
+    let quoted = false;
+    for (let index = 0; index < content.length; index++) {
+        const character = content.charAt(index);
+        if (quoted) {
+            if (character !== '"') {
+                cell += character;
+            }
+            else if (content[index + 1] === '"') {
+                cell += '"';
+                index++;
+            }
+            else {
+                quoted = false;
+            }
+            continue;
+        }
+        if (character === '"' && cell === '') {
+            quoted = true;
+        }
+        else if (character === delimiter) {
+            row.push(cell);
+            cell = '';
+        }
+        else if (character === '\n' || character === '\r') {
+            if (character === '\r' && content[index + 1] === '\n')
+                index++;
+            row.push(cell);
+            if (!isBlank(row))
+                rows.push(row);
+            row = [];
+            cell = '';
+        }
+        else {
+            cell += character;
+        }
+    }
+    row.push(cell);
+    if (!isBlank(row))
+        rows.push(row);
+    return rows;
+}
+/**
+ * Guess what separates the cells of a piece of delimited text.
+ *
+ * The candidates are counted outside quotes over the first few lines, so a
+ * comma inside a compound name does not win against the tabs actually
+ * separating the columns.
+ * @param text - The file, as text.
+ * @returns The separator, falling back to the tab when nothing separates
+ *   anything.
+ */
+export function detectDelimiter(text) {
+    let best = DEFAULT_DELIMITER;
+    let bestCount = 0;
+    for (const candidate of CANDIDATES) {
+        const count = countOutsideQuotes(text, candidate);
+        if (count > bestCount) {
+            best = candidate;
+            bestCount = count;
+        }
+    }
+    return best;
+}
+function isBlank(row) {
+    return row.length === 1 && row[0] === '';
+}
+/** The separators a file we read is allowed to use, in order of preference. */
+const CANDIDATES = ['\t', ',', ';'];
+/** How many lines of the file the guess is made from. */
+const SAMPLED_LINES = 10;
+function countOutsideQuotes(text, delimiter) {
+    let count = 0;
+    let lines = 0;
+    let quoted = false;
+    for (let index = 0; index < text.length; index++) {
+        const character = text.charAt(index);
+        if (quoted) {
+            if (character === '"') {
+                if (text[index + 1] === '"') {
+                    index++;
+                }
+                else {
+                    quoted = false;
+                }
+            }
+            continue;
+        }
+        if (character === '"') {
+            quoted = true;
+        }
+        else if (character === delimiter) {
+            count++;
+        }
+        else if (character === '\n') {
+            lines++;
+            if (lines >= SAMPLED_LINES)
+                break;
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=readDelimited.js.map

package/lib/delimited/core/readDelimited.js.map

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

package/lib/delimited/core/rowsToDelimited.d.ts

@@ -0,0 +1,59 @@
+/** One column of a table written from objects. */
+export interface DelimitedColumn {
+    /** Property of each object this column reads. */
+    key: string;
+    /**
+     * What the column is called in the header line.
+     * @default the key
+     */
+    label?: string;
+    /**
+     * How a value of this column is written.
+     * @default {@link formatCell}
+     */
+    format?: (value: unknown) => string;
+}
+/** How a table of objects is written out. */
+export interface RowsToDelimitedOptions {
+    /**
+     * What separates two cells.
+     * @default '\t'
+     */
+    delimiter?: string;
+    /**
+     * Whether the column names are written as the first line.
+     * @default true
+     */
+    header?: boolean;
+    /**
+     * What ends a line.
+     * @default '\n'
+     */
+    newline?: string;
+}
+/**
+ * Write a list of objects out as delimited text, one column per named field.
+ *
+ * The columns are what makes the file readable: they fix the order, they name
+ * the header, and they are the only fields written — a row carrying more is not
+ * silently widened, and one carrying less gets an empty cell rather than
+ * shifting every column after it.
+ * @param rows - The objects, one per line.
+ * @param columns - The columns, in order; a plain string names a column that
+ *   reads the property of the same name.
+ * @param options - See {@link RowsToDelimitedOptions}.
+ * @returns The text.
+ */
+export declare function rowsToDelimited(rows: ReadonlyArray<Readonly<Record<string, unknown>>>, columns: ReadonlyArray<string | DelimitedColumn>, options?: RowsToDelimitedOptions): string;
+/**
+ * Write one value the way a spreadsheet reads it.
+ *
+ * Nothing at all — `undefined`, `null`, or a number that is not one — becomes
+ * an empty cell, which is what a spreadsheet means by a missing value; a date
+ * becomes its ISO form, a list becomes its entries separated by `; `, and
+ * anything else becomes its JSON, which at least says what was there.
+ * @param value - The value.
+ * @returns The cell.
+ */
+export declare function formatCell(value: unknown): string;
+//# sourceMappingURL=rowsToDelimited.d.ts.map

package/lib/delimited/core/rowsToDelimited.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rowsToDelimited.d.ts","sourceRoot":"","sources":["../../../src/delimited/core/rowsToDelimited.ts"],"names":[],"mappings":"AAGA,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CACrC;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EACtD,OAAO,EAAE,aAAa,CAAC,MAAM,GAAG,eAAe,CAAC,EAChD,OAAO,GAAE,sBAA2B,GACnC,MAAM,CAsBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAqBjD"}

package/lib/delimited/core/rowsToDelimited.js

@@ -0,0 +1,87 @@
+import { DEFAULT_DELIMITER } from "./delimiters.js";
+import { toDelimited } from "./toDelimited.js";
+/**
+ * Write a list of objects out as delimited text, one column per named field.
+ *
+ * The columns are what makes the file readable: they fix the order, they name
+ * the header, and they are the only fields written — a row carrying more is not
+ * silently widened, and one carrying less gets an empty cell rather than
+ * shifting every column after it.
+ * @param rows - The objects, one per line.
+ * @param columns - The columns, in order; a plain string names a column that
+ *   reads the property of the same name.
+ * @param options - See {@link RowsToDelimitedOptions}.
+ * @returns The text.
+ */
+export function rowsToDelimited(rows, columns, options = {}) {
+    const { delimiter = DEFAULT_DELIMITER, header = true, newline = '\n', } = options;
+    const resolved = resolveColumns(columns);
+    const cells = [];
+    for (const row of rows) {
+        const line = [];
+        for (const { key, format } of resolved) {
+            line.push(format(row[key]));
+        }
+        cells.push(line);
+    }
+    return toDelimited(cells, {
+        delimiter,
+        newline,
+        header: header ? resolved.map((column) => column.label) : undefined,
+    });
+}
+/**
+ * Write one value the way a spreadsheet reads it.
+ *
+ * Nothing at all — `undefined`, `null`, or a number that is not one — becomes
+ * an empty cell, which is what a spreadsheet means by a missing value; a date
+ * becomes its ISO form, a list becomes its entries separated by `; `, and
+ * anything else becomes its JSON, which at least says what was there.
+ * @param value - The value.
+ * @returns The cell.
+ */
+export function formatCell(value) {
+    if (value === undefined || value === null)
+        return '';
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? String(value) : '';
+    }
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'bigint')
+        return value.toString();
+    if (Array.isArray(value)) {
+        const parts = [];
+        for (const entry of value) {
+            parts.push(formatCell(entry));
+        }
+        return parts.join('; ');
+    }
+    try {
+        return JSON.stringify(value) ?? '';
+    }
+    catch {
+        return '';
+    }
+}
+function resolveColumns(columns) {
+    const resolved = [];
+    for (const column of columns) {
+        if (typeof column === 'string') {
+            resolved.push({ key: column, label: column, format: formatCell });
+        }
+        else {
+            resolved.push({
+                key: column.key,
+                label: column.label ?? column.key,
+                format: column.format ?? formatCell,
+            });
+        }
+    }
+    return resolved;
+}
+//# sourceMappingURL=rowsToDelimited.js.map

package/lib/delimited/core/rowsToDelimited.js.map

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

package/lib/delimited/core/toDelimited.d.ts

@@ -0,0 +1,38 @@
+/** How a table is written out. */
+export interface ToDelimitedOptions {
+    /**
+     * What separates two cells.
+     * @default '\t'
+     */
+    delimiter?: string;
+    /**
+     * Column names, written as the first line.
+     * @default undefined — the table is written without a header line
+     */
+    header?: readonly string[];
+    /**
+     * What ends a line.
+     * @default '\n'
+     */
+    newline?: string;
+}
+/**
+ * Write a table out as delimited text.
+ *
+ * Every cell is escaped, whatever the separator: a value holding the separator,
+ * a quote or a newline is quoted and its quotes doubled, per RFC 4180. Joining
+ * on a tab and hoping no cell holds one is what silently corrupts a file the
+ * day a compound name carries a comma or a source a line break.
+ * @param rows - The cells, one array per line.
+ * @param options - See {@link ToDelimitedOptions}.
+ * @returns The text, header line first when there is one.
+ */
+export declare function toDelimited(rows: ReadonlyArray<readonly string[]>, options?: ToDelimitedOptions): string;
+/**
+ * Write one cell so reading it back gives exactly what went in.
+ * @param value - The cell.
+ * @param delimiter - What separates two cells in this file.
+ * @returns The cell, quoted when it has to be.
+ */
+export declare function escapeCell(value: string, delimiter: string): string;
+//# sourceMappingURL=toDelimited.d.ts.map

package/lib/delimited/core/toDelimited.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDelimited.d.ts","sourceRoot":"","sources":["../../../src/delimited/core/toDelimited.ts"],"names":[],"mappings":"AAEA,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,aAAa,CAAC,SAAS,MAAM,EAAE,CAAC,EACtC,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CASR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQnE"}

package/lib/delimited/core/toDelimited.js

@@ -0,0 +1,45 @@
+import { DEFAULT_DELIMITER } from "./delimiters.js";
+/**
+ * Write a table out as delimited text.
+ *
+ * Every cell is escaped, whatever the separator: a value holding the separator,
+ * a quote or a newline is quoted and its quotes doubled, per RFC 4180. Joining
+ * on a tab and hoping no cell holds one is what silently corrupts a file the
+ * day a compound name carries a comma or a source a line break.
+ * @param rows - The cells, one array per line.
+ * @param options - See {@link ToDelimitedOptions}.
+ * @returns The text, header line first when there is one.
+ */
+export function toDelimited(rows, options = {}) {
+    const { delimiter = DEFAULT_DELIMITER, header, newline = '\n' } = options;
+    const lines = [];
+    if (header !== undefined)
+        lines.push(writeLine(header, delimiter));
+    for (const row of rows) {
+        lines.push(writeLine(row, delimiter));
+    }
+    return lines.join(newline);
+}
+/**
+ * Write one cell so reading it back gives exactly what went in.
+ * @param value - The cell.
+ * @param delimiter - What separates two cells in this file.
+ * @returns The cell, quoted when it has to be.
+ */
+export function escapeCell(value, delimiter) {
+    const mustQuote = value.includes(delimiter) ||
+        value.includes('"') ||
+        value.includes('\n') ||
+        value.includes('\r');
+    if (!mustQuote)
+        return value;
+    return `"${value.replaceAll('"', '""')}"`;
+}
+function writeLine(cells, delimiter) {
+    const escaped = [];
+    for (const cell of cells) {
+        escaped.push(escapeCell(cell, delimiter));
+    }
+    return escaped.join(delimiter);
+}
+//# sourceMappingURL=toDelimited.js.map

package/lib/delimited/core/toDelimited.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDelimited.js","sourceRoot":"","sources":["../../../src/delimited/core/toDelimited.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAqBpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,IAAsC,EACtC,UAA8B,EAAE;IAEhC,MAAM,EAAE,SAAS,GAAG,iBAAiB,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE1E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IACnE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,SAAiB;IACzD,MAAM,SAAS,GACb,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;AAC5C,CAAC;AAED,SAAS,SAAS,CAAC,KAAwB,EAAE,SAAiB;IAC5D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}