@graview/core 0.1.28 → 0.1.30

package/dist/import/coerce.js

@@ -0,0 +1,252 @@
+import { nameKey } from "../labels.js";
+import { slug } from "../mutations/define-mutation.js";
+import { isAppAddress } from "../schema/app-link.js";
+import { PHONE } from "../schema/typed-fields.js";
+import { parseDuration } from "../schema/field-words.js";
+const MONTHS = ["jan", "feb", "mar", "apr", "may", "jun", "jul", "aug", "sep", "oct", "nov", "dec"];
+const pad = (n) => String(n).padStart(2, "0");
+/** Whether a day is on the calendar: February has no 30th. */
+function realDay(year, month, day) {
+    if (month < 1 || month > 12 || day < 1 || year < 1000 || year > 9999)
+        return false;
+    const date = new Date(Date.UTC(year, month - 1, day));
+    return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+}
+const fullYear = (year) => (year.length === 2 ? 2000 + Number(year) : Number(year));
+function monthOf(word) {
+    const at = MONTHS.indexOf(word.toLowerCase().replace(/\.$/, "").slice(0, 3));
+    return at < 0 ? undefined : at + 1;
+}
+/** A day, as `YYYY-MM-DD`: ISO, US `M/D/YYYY` (or day first), "Sep 10, 2023", "10 September 2023", a spreadsheet's serial day. */
+export function readDay(input, options = {}) {
+    if (input instanceof Date) {
+        if (Number.isNaN(input.getTime()))
+            return undefined;
+        return `${input.getUTCFullYear()}-${pad(input.getUTCMonth() + 1)}-${pad(input.getUTCDate())}`;
+    }
+    if (typeof input === "number")
+        return serialDay(input);
+    const text = String(input).trim().replace(/,/g, " ").replace(/\s+/g, " ");
+    const day = (year, month, date) => (realDay(year, month, date) ? `${year}-${pad(month)}-${pad(date)}` : undefined);
+    let match = /^(\d{4})-(\d{1,2})-(\d{1,2})(?:[T ].*)?$/.exec(text);
+    if (match)
+        return day(Number(match[1]), Number(match[2]), Number(match[3]));
+    match = /^(\d{4})\/(\d{1,2})\/(\d{1,2})$/.exec(text);
+    if (match)
+        return day(Number(match[1]), Number(match[2]), Number(match[3]));
+    match = /^(\d{1,2})[/.-](\d{1,2})[/.-](\d{2}|\d{4})(?: .*)?$/.exec(text);
+    if (match) {
+        const [first, second] = [Number(match[1]), Number(match[2])];
+        const year = fullYear(match[3]);
+        return options.dayFirst ? day(year, second, first) : day(year, first, second);
+    }
+    // "Sep 10 2023", "September 10th 2023", "Sept. 10 2023"
+    match = /^([A-Za-z]+\.?) (\d{1,2})(?:st|nd|rd|th)? (\d{4})$/.exec(text);
+    if (match) {
+        const month = monthOf(match[1]);
+        return month ? day(Number(match[3]), month, Number(match[2])) : undefined;
+    }
+    // "10 Sep 2023", "10th of September 2023"
+    match = /^(\d{1,2})(?:st|nd|rd|th)? (?:of )?([A-Za-z]+\.?) (\d{4})$/.exec(text);
+    if (match) {
+        const month = monthOf(match[2]);
+        return month ? day(Number(match[3]), month, Number(match[1])) : undefined;
+    }
+    if (/^\d{5}(\.\d+)?$/.test(text))
+        return serialDay(Number(text));
+    return undefined;
+}
+/** A spreadsheet's serial day (days since 1899-12-30), in the years a sheet plausibly holds. */
+function serialDay(serial) {
+    if (!Number.isFinite(serial) || serial < 20000 || serial > 80000)
+        return undefined;
+    const date = new Date(Date.UTC(1899, 11, 30) + Math.floor(serial) * 86_400_000);
+    return `${date.getUTCFullYear()}-${pad(date.getUTCMonth() + 1)}-${pad(date.getUTCDate())}`;
+}
+/** A day and a time, as `YYYY-MM-DDTHH:MM`: the day as `readDay` reads it, then "14:30", "2:30 PM" or "2pm". */
+export function readDateTime(input, options = {}) {
+    if (input instanceof Date) {
+        if (Number.isNaN(input.getTime()))
+            return undefined;
+        return `${readDay(input)}T${pad(input.getUTCHours())}:${pad(input.getUTCMinutes())}`;
+    }
+    const text = String(input).trim();
+    const iso = /^(\d{4}-\d{2}-\d{2})[T ](\d{1,2}):(\d{2})(?::\d{2}(?:\.\d+)?)?\s*(Z|[+-]\d{2}:?\d{2})?$/.exec(text);
+    if (iso) {
+        const written = text.replace(" ", "T");
+        // With a zone it is an instant, kept as written; without one, the day and the time of day.
+        if (iso[4])
+            return Number.isNaN(Date.parse(written)) ? undefined : written;
+        const [hour, minute] = [Number(iso[2]), Number(iso[3])];
+        return readDay(iso[1]) && hour < 24 && minute < 60 ? `${iso[1]}T${pad(hour)}:${pad(minute)}` : undefined;
+    }
+    const timed = /^(.*?)[ T,]+(\d{1,2})(?::(\d{2}))?\s*([AaPp]\.?[Mm]\.?)?$/.exec(text);
+    if (timed && (timed[3] !== undefined || timed[4] !== undefined)) {
+        const day = readDay(timed[1], options);
+        let hour = Number(timed[2]);
+        const minute = Number(timed[3] ?? 0);
+        const half = timed[4]?.toLowerCase().replace(/\./g, "");
+        if (half) {
+            if (hour < 1 || hour > 12)
+                return undefined;
+            hour = (hour % 12) + (half === "pm" ? 12 : 0);
+        }
+        if (!day || hour > 23 || minute > 59)
+            return undefined;
+        return `${day}T${pad(hour)}:${pad(minute)}`;
+    }
+    const day = readDay(text, options);
+    return day ? `${day}T00:00` : undefined;
+}
+/**
+ * A number, however a sheet wrote it: "$1,200.50", "USD 40", "12 kg",
+ * "(300)" for a loss, "15%" for 0.15. One number per cell; text before or
+ * after it — a currency, a unit — is set aside, text between two numbers
+ * is not a number.
+ */
+export function readNumber(input) {
+    if (typeof input === "number")
+        return Number.isFinite(input) ? input : undefined;
+    let text = String(input).trim().replace(/\u00a0/g, " ");
+    if (text.length === 0)
+        return undefined;
+    let sign = 1;
+    const parenthesized = /^\((.*)\)$/.exec(text);
+    if (parenthesized) {
+        sign = -1;
+        text = parenthesized[1].trim();
+    }
+    const match = /^([^\d.+-]*?)\s*([+\-−]?)\s*([^\d.+-]*?)\s*(\d[\d,]*(?:\.\d+)?|\.\d+)\s*(%?)\s*([^\d]*)$/.exec(text);
+    if (!match)
+        return undefined;
+    const [, before, minus, between, digits, percent, after] = match;
+    // What stands around a number is a currency or a unit, a word or a symbol; never a stray number or another sign.
+    if (/[+-]/.test(after) || (before && between))
+        return undefined;
+    if (/,/.test(digits) && !/^\d{1,3}(,\d{3})+(\.\d+)?$/.test(digits))
+        return undefined;
+    const value = Number(digits.replace(/,/g, ""));
+    if (!Number.isFinite(value))
+        return undefined;
+    const signed = value * sign * (minus === "-" || minus === "−" ? -1 : 1);
+    return percent ? signed / 100 : signed;
+}
+const YES = new Set(["yes", "y", "true", "t", "x", "1", "on", "checked", "done", "✓", "✔", "☑", "✅"]);
+const NO = new Set(["no", "n", "false", "f", "0", "off", "unchecked", "-", "✗", "✘", "☐", "❌"]);
+/** A yes or a no: yes/no, true/false, x, ✓, 1/0. */
+export function readBoolean(input) {
+    if (typeof input === "boolean")
+        return input;
+    const text = String(input).trim().toLowerCase();
+    if (YES.has(text))
+        return true;
+    if (NO.has(text))
+        return false;
+    return undefined;
+}
+/** One of a field's options, by the option itself or its words, case and spacing aside. */
+export function readOption(input, options, words) {
+    const text = String(input).trim();
+    const key = nameKey(text);
+    const keyed = slug(text);
+    return (options.find((option) => option === text) ??
+        options.find((option) => nameKey(option) === key) ??
+        options.find((option) => words !== undefined && nameKey(words(option)) === key) ??
+        options.find((option) => slug(option) === keyed));
+}
+/** Several values in one cell: split on semicolons and line breaks, and on commas when there were none. */
+export function splitCell(text) {
+    const parts = /[;\n]/.test(text) ? text.split(/[;\n]/) : text.split(",");
+    return parts.map((part) => part.trim()).filter((part) => part.length > 0);
+}
+/** A cell read as a field of this spec. Blank cells are not handed here. */
+export function coerceCell(spec, input, said, options = {}) {
+    const quoted = `“${input instanceof Date ? input.toISOString().slice(0, 10) : String(input).trim()}”`;
+    switch (spec.type) {
+        case "string":
+        case "text":
+            return { ok: true, value: input instanceof Date ? readDay(input) : String(input).trim() };
+        case "email":
+            return { ok: true, value: String(input).trim() };
+        case "url": {
+            const text = String(input).trim();
+            // "bloomandco.com" is an address a person would write; the field holds one a browser follows.
+            return { ok: true, value: /^[a-z][a-z0-9+.-]*:/i.test(text) || !/^[^\s/]+\.[^\s]+$/.test(text) ? text : `https://${text}` };
+        }
+        case "number":
+        case "integer": {
+            const value = readNumber(input);
+            if (value === undefined)
+                return { ok: false, why: `${quoted} under ${said} is not a number` };
+            if (spec.type === "integer" && !Number.isInteger(value))
+                return { ok: false, why: `${quoted} under ${said} is not a whole number` };
+            return { ok: true, value };
+        }
+        case "boolean": {
+            const value = readBoolean(input);
+            return value === undefined ? { ok: false, why: `${quoted} under ${said} is not a yes or a no` } : { ok: true, value };
+        }
+        case "date": {
+            const value = readDay(input, options);
+            return value === undefined ? { ok: false, why: `${quoted} under ${said} is not a date` } : { ok: true, value };
+        }
+        case "datetime": {
+            const value = readDateTime(input, options);
+            return value === undefined ? { ok: false, why: `${quoted} under ${said} is not a date and time` } : { ok: true, value };
+        }
+        case "enum": {
+            const choices = spec.options ?? [];
+            const value = readOption(input, choices, options.optionWords);
+            if (value !== undefined)
+                return { ok: true, value };
+            const listed = choices.map((option) => options.optionWords?.(option) ?? option);
+            return { ok: false, why: `${quoted} under ${said} is none of ${listed.length <= 8 ? orList(listed) : `its ${listed.length} choices`}` };
+        }
+        case "list": {
+            const items = Array.isArray(input) ? input : splitCell(String(input));
+            const out = [];
+            for (const item of items) {
+                const one = coerceCell({ type: spec.of === "number" ? "number" : spec.of === "date" ? "date" : "string" }, item, said, options);
+                if (!one.ok)
+                    return one;
+                out.push(one.value);
+            }
+            return { ok: true, value: out };
+        }
+        case "image":
+        case "file":
+            return { ok: false, why: `${said} holds a file, which a cell cannot carry` };
+        case "app-link": {
+            // Another app's address (FR-171), as it is written: @owner/app, an id, or an https:// address.
+            const text = String(input).trim();
+            return isAppAddress(text) ? { ok: true, value: text } : { ok: false, why: `${quoted} under ${said} is not another app's address` };
+        }
+        case "phone": {
+            // As it is written; a spreadsheet that kept it as a number gives its digits.
+            const text = String(input).trim();
+            return text.length <= 40 && PHONE.test(text) ? { ok: true, value: text } : { ok: false, why: `${quoted} under ${said} is not a phone number` };
+        }
+        case "place": {
+            const text = String(input).trim();
+            return text.length <= 300 ? { ok: true, value: text } : { ok: false, why: `${quoted} under ${said} is longer than a place's 300 characters` };
+        }
+        case "duration": {
+            // Minutes, or a length of time as it is typed: "1h 30m", "1:30", "1.5 h".
+            const value = parseDuration(typeof input === "number" || typeof input === "string" ? input : String(input));
+            return value === undefined ? { ok: false, why: `${quoted} under ${said} is not a length of time, like 1h 30m or 90 (minutes)` } : { ok: true, value };
+        }
+    }
+}
+/** "a, b or c". */
+export function orList(items) {
+    if (items.length <= 1)
+        return items.join("");
+    return `${items.slice(0, -1).join(", ")} or ${items.at(-1)}`;
+}
+/** "a, b and c". */
+export function andList(items) {
+    if (items.length <= 1)
+        return items.join("");
+    return `${items.slice(0, -1).join(", ")} and ${items.at(-1)}`;
+}
+//# sourceMappingURL=coerce.js.map

package/dist/import/coerce.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coerce.js","sourceRoot":"","sources":["../../src/import/coerce.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iCAAiC,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAkBzD,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAEpG,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAEtD,8DAA8D;AAC9D,SAAS,OAAO,CAAC,IAAY,EAAE,KAAa,EAAE,GAAW;IACvD,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI;QAAE,OAAO,KAAK,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,CAAC;AACzG,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AAE5F,SAAS,OAAO,CAAC,IAAY;IAC3B,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7E,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,kIAAkI;AAClI,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,UAAyB,EAAE;IACjE,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QACpD,OAAO,GAAG,KAAK,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;IAChG,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,KAAa,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3I,IAAI,KAAK,GAAG,0CAA0C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,KAAK;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,KAAK,GAAG,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzE,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAChF,CAAC;IACD,wDAAwD;IACxD,KAAK,GAAG,oDAAoD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxE,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,CAAC;IACD,0CAA0C;IAC1C,KAAK,GAAG,4DAA4D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChF,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;QACjC,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,CAAC;IACD,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,gGAAgG;AAChG,SAAS,SAAS,CAAC,MAAc;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,KAAK,IAAI,MAAM,GAAG,KAAK;QAAE,OAAO,SAAS,CAAC;IACnF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;IAChF,OAAO,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,UAAyB,EAAE;IACtE,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YAAE,OAAO,SAAS,CAAC;QACpD,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,yFAAyF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjH,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,2FAA2F;QAC3F,IAAI,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;QAC3E,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3G,CAAC;IACD,MAAM,KAAK,GAAG,2DAA2D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrF,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,CAAC;QAChE,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxD,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE;gBAAE,OAAO,SAAS,CAAC;YAC5C,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,IAAI,MAAM,GAAG,EAAE;YAAE,OAAO,SAAS,CAAC;QACvD,OAAO,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;IAC9C,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,IAAI,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACxD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,aAAa,EAAE,CAAC;QAClB,IAAI,GAAG,CAAC,CAAC,CAAC;QACV,IAAI,GAAG,aAAa,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,KAAK,GAAG,0FAA0F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpH,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IACjE,iHAAiH;IACjH,IAAI,MAAM,CAAC,IAAI,CAAC,KAAM,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACjE,IAAI,GAAG,CAAC,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,MAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AACtG,MAAM,EAAE,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAEhG,oDAAoD;AACpD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,UAAU,CAAC,KAAc,EAAE,OAA0B,EAAE,KAAkC;IACvG,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,CACL,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC;QACjD,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,CAAC;QAC/E,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CACjD,CAAC;AACJ,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,KAAc,EAAE,IAAY,EAAE,UAAyB,EAAE;IACnG,MAAM,MAAM,GAAG,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC;IACtG,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5F,KAAK,OAAO;YACV,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACnD,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,8FAA8F;YAC9F,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;QAC9H,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,kBAAkB,EAAE,CAAC;YAC9F,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;gBAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,wBAAwB,EAAE,CAAC;YACpI,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YACjC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,uBAAuB,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxH,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACjH,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC3C,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,yBAAyB,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC1H,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;YAC9D,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC;YAChF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,eAAe,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,UAAU,EAAE,EAAE,CAAC;QAC1I,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,MAAM,GAAG,GAAc,EAAE,CAAC;YAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;gBAChI,IAAI,CAAC,GAAG,CAAC,EAAE;oBAAE,OAAO,GAAG,CAAC;gBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAClC,CAAC;QACD,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,0CAA0C,EAAE,CAAC;QAC/E,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,+FAA+F;YAC/F,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,+BAA+B,EAAE,CAAC;QACrI,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,6EAA6E;YAC7E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,MAAM,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,wBAAwB,EAAE,CAAC;QACjJ,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,0CAA0C,EAAE,CAAC;QAChJ,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,0EAA0E;YAC1E,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5G,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,UAAU,IAAI,uDAAuD,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACxJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,mBAAmB;AACnB,MAAM,UAAU,MAAM,CAAC,KAAwB;IAC7C,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,OAAO,CAAC,KAAwB;IAC9C,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAChE,CAAC"}

package/dist/import/csv.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A SPREADSHEET SAVED AS TEXT, read as rows (FR-177): RFC 4180's quoting —
+ * a field in double quotes may hold the delimiter, a line break, and a
+ * quote written twice — CRLF, LF or CR line ends, and the byte-order mark
+ * Excel writes at the front. A host is as likely to be handed a paste as a
+ * file, so the delimiter is read off the first line when it is not given:
+ * a tab (a paste from a sheet), a semicolon (a sheet saved where a comma is
+ * the decimal mark) or a comma. A blank line is kept as a row of blanks, so
+ * every row keeps the number the sheet gave it; `importRows` passes over it.
+ */
+export interface CsvOptions {
+    /** The character between fields. Unsaid, read off the first line: tab, semicolon or comma. */
+    readonly delimiter?: string;
+}
+export declare function parseCsv(text: string, options?: CsvOptions): string[][];
+//# sourceMappingURL=csv.d.ts.map

package/dist/import/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../src/import/csv.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,EAAE,EAAE,CAwD3E"}

package/dist/import/csv.js

@@ -0,0 +1,77 @@
+export function parseCsv(text, options = {}) {
+    const source = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    const delimiter = options.delimiter ?? sniff(source);
+    const rows = [];
+    let row = [];
+    let field = "";
+    let quoted = false;
+    let at = 0;
+    const endField = () => {
+        row.push(field);
+        field = "";
+    };
+    const endRow = () => {
+        endField();
+        rows.push(row);
+        row = [];
+    };
+    while (at < source.length) {
+        const char = source[at];
+        if (quoted) {
+            if (char === '"') {
+                if (source[at + 1] === '"') {
+                    field += '"';
+                    at += 2;
+                    continue;
+                }
+                quoted = false;
+                at += 1;
+                continue;
+            }
+            field += char;
+            at += 1;
+            continue;
+        }
+        if (char === '"' && field.trim().length === 0) {
+            // A quote opens a field only at its start; spaces before it are not the field's.
+            field = "";
+            quoted = true;
+            at += 1;
+            continue;
+        }
+        if (char === delimiter) {
+            endField();
+            at += 1;
+            continue;
+        }
+        if (char === "\r" || char === "\n") {
+            endRow();
+            at += char === "\r" && source[at + 1] === "\n" ? 2 : 1;
+            continue;
+        }
+        field += char;
+        at += 1;
+    }
+    if (field.length > 0 || row.length > 0)
+        endRow();
+    return rows;
+}
+/** The delimiter the first line uses most, outside quotes: tab, semicolon or comma. */
+function sniff(text) {
+    const counts = new Map([["\t", 0], [";", 0], [",", 0]]);
+    let quoted = false;
+    for (const char of text) {
+        if (char === '"')
+            quoted = !quoted;
+        else if (!quoted && (char === "\n" || char === "\r"))
+            break;
+        else if (!quoted && counts.has(char))
+            counts.set(char, counts.get(char) + 1);
+    }
+    let best = ",";
+    for (const [delimiter, count] of counts)
+        if (count > (counts.get(best) ?? 0))
+            best = delimiter;
+    return best;
+}
+//# sourceMappingURL=csv.js.map

package/dist/import/csv.js.map

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

package/dist/import/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@graview/core/import` — A SPREADSHEET BROUGHT IN (FR-177): rows to
+ * records as one batch, undone as one, attributed to whoever imported
+ * them; a preview that says per row what would be made, linked and
+ * refused; a mapping proposed from the header row; and a CSV reader for
+ * a host handed text. An entry of its own: a hosted page draws without
+ * ever importing, so it carries none of this.
+ */
+export { importRows, previewImport } from "./rows.js";
+export type { ImportChange, ImportLink, ImportOptions, ImportResult, ImportRow, ImportRowOutcome } from "./rows.js";
+export { ImportMappingError, proposeMapping } from "./mapping.js";
+export type { ColumnTarget, ImportMapping, ImportMatch, ProposedColumn, ProposedMapping } from "./mapping.js";
+export { coerceCell, readBoolean, readDateTime, readDay, readNumber, readOption } from "./coerce.js";
+export type { CoerceOptions, Coerced } from "./coerce.js";
+export { parseCsv } from "./csv.js";
+export type { CsvOptions } from "./csv.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACpH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrG,YAAY,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpC,YAAY,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

package/dist/import/index.js

@@ -0,0 +1,13 @@
+/**
+ * `@graview/core/import` — A SPREADSHEET BROUGHT IN (FR-177): rows to
+ * records as one batch, undone as one, attributed to whoever imported
+ * them; a preview that says per row what would be made, linked and
+ * refused; a mapping proposed from the header row; and a CSV reader for
+ * a host handed text. An entry of its own: a hosted page draws without
+ * ever importing, so it carries none of this.
+ */
+export { importRows, previewImport } from "./rows.js";
+export { ImportMappingError, proposeMapping } from "./mapping.js";
+export { coerceCell, readBoolean, readDateTime, readDay, readNumber, readOption } from "./coerce.js";
+export { parseCsv } from "./csv.js";
+//# sourceMappingURL=index.js.map

package/dist/import/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/import/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAElE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAErG,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/import/mapping.d.ts

@@ -0,0 +1,99 @@
+import type { FieldSpec } from "../document/schema.js";
+import type { AnySchema } from "../schema/schema.js";
+import type { AnyNodeDefinition } from "../schema/types.js";
+/**
+ * WHERE A COLUMN GOES (FR-177): a field of the kind, by its name; a relation,
+ * by its name — one the kind declares (`out`, the default) or one another
+ * kind declares toward it (`in`, found by name when the kind declares none
+ * so called); `null` (or a column left out) is not imported.
+ */
+export type ColumnTarget = string | {
+    readonly field: string;
+} | {
+    readonly relation: string;
+    readonly direction?: "out" | "in";
+} | null;
+/** Column header → where its cells go. */
+export type ImportMapping = Readonly<Record<string, ColumnTarget>>;
+/**
+ * How a row finds the record it already is (`ImportOptions.match`): by what
+ * the row would call it, or by one column's value against one field.
+ */
+export type ImportMatch = "label" | {
+    readonly column: string;
+    readonly field: string;
+};
+/** A column, read against the declaration. */
+export type ImportColumn = {
+    readonly column: string;
+    readonly as: "field";
+    readonly field: string;
+    readonly spec: FieldSpec;
+    /** The zod field itself, which has the last word on what fits. */
+    readonly schema: unknown;
+} | {
+    readonly column: string;
+    readonly as: "relation";
+    readonly relation: string;
+    readonly direction: "out" | "in";
+    /** The kinds a cell may name. */
+    readonly kinds: readonly string[];
+    /** The new record links to at most one (`out`), or the far record holds at most one such link (`in`). */
+    readonly one: boolean;
+};
+/** A mapping that names something the kind has not got. Thrown before any row is read: it is the caller's to fix, not the sheet's. */
+export declare class ImportMappingError extends Error {
+    readonly problems: readonly string[];
+    constructor(problems: readonly string[]);
+}
+type SchemaLike = AnySchema | {
+    readonly schema: AnySchema;
+};
+/** The kind's field as an import reads it: its document spec, or a word when a document has no type for it. */
+export declare function fieldSpecFor(definition: AnyNodeDefinition, field: string): {
+    readonly spec: FieldSpec;
+    readonly schema: unknown;
+} | undefined;
+/** Reads a mapping against the kind's declaration; a target it has not got is an `ImportMappingError`. */
+export declare function readMapping(schema: AnySchema, kind: string, mapping: ImportMapping, 
+/** The fields the importer's sight keeps from it (Roadmap f-field-sight): to the importer, fields the kind does not have. */
+kept?: (field: string) => boolean): readonly ImportColumn[];
+/** A column's place in a proposal: where it goes, and the words it was matched by. */
+export interface ProposedColumn {
+    readonly column: string;
+    readonly target: Exclude<ColumnTarget, string | null>;
+    /** What the header was matched to, in the declaration's words: "the field Booked on", "the relation to an event". */
+    readonly said: string;
+}
+/** What `proposeMapping` offers: a mapping to hand `importRows`, each column's reason, and what is left. */
+export interface ProposedMapping {
+    readonly mapping: ImportMapping;
+    readonly columns: readonly ProposedColumn[];
+    /** Headers nothing in the kind answers to: not imported unless somebody maps them. */
+    readonly unmatched: readonly string[];
+    /** Required fields no column fills, by their words: every row would be refused for want of them. */
+    readonly missing: readonly string[];
+    /**
+     * How a row could find the record it already is, to hand `importRows` as
+     * `match` when the sheet may hold records the app has: a column of a key —
+     * an email, a code, a reference — else the column the kind's name is read
+     * from. Unsaid where no column answers either way. Never applied on its
+     * own: importing without `match` makes every row.
+     */
+    readonly match?: ImportMatch;
+    /** The suggestion in words: "rows are matched to vendors by Email". */
+    readonly matchSaid?: string;
+}
+/**
+ * A MAPPING PROPOSED FROM THE HEADER ROW (FR-177), for the seat or a
+ * builder to offer and a person to correct. A header matches a field by
+ * its name, its label or its name spoken ("Booked on" for `bookedOn`), a
+ * plural aside; a relation by its name, its words from either end, or the
+ * noun or plural of the kind at its far end ("Event" for a link to an
+ * event). A header that starts with the kind's own noun is read without it
+ * ("Vendor name" is the name). Each field or relation is matched once, by
+ * the first header that names it; what nothing answers to is `unmatched`.
+ */
+export declare function proposeMapping(declaration: SchemaLike, kind: string, header: readonly string[]): ProposedMapping;
+export {};
+//# sourceMappingURL=mapping.d.ts.map

package/dist/import/mapping.d.ts.map

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