@graphty/graph-io 0.0.0 → 0.2.0

package/dist/src/common/report.js

@@ -0,0 +1,274 @@
+/**
+ * The ImportReport builder shared by every importer (design section 8.6): issues by category and
+ * severity, the element counts, loss notes, the error limit with truncation, and the ImportError
+ * that carries the partial report when the importer aborts.
+ *
+ * Layering (design section 8.6): the builder throws on the first hard error; the importer catches
+ * per element, records an ImportIssue through this class, skips the element and continues until the
+ * error limit, then aborts with E_IMPORT. `recordError()` is that catch: it turns a thrown
+ * GraphFormatError into an issue with the category its code implies and re-throws everything else
+ * (an ImportError, an abort reason, a programming error) unchanged.
+ */
+import { GraphFormatError } from "@graphty/graph-format";
+import { ImportError } from "../types.js";
+/**
+ * The category a thrown GraphFormatError maps to when an importer catches it per element: the codes
+ * that mean "the file referenced something it never declared" are missing values, a refused
+ * direction change is a coercion, size and feature limits are unsupported, everything else is a
+ * validation error of the element.
+ */
+const CATEGORY_BY_CODE = {
+    E_UNKNOWN_NODE: "missing-value",
+    E_UNKNOWN_COLUMN: "missing-value",
+    E_DIRECTED: "coercion",
+    E_TOO_LARGE: "unsupported",
+    E_UNSUPPORTED: "unsupported",
+    E_GPU_INELIGIBLE: "unsupported",
+};
+/**
+ * The code a report used to give a thrown value that was not a GraphFormatError. Since audit round
+ * 1 such a value (a TypeError, a RangeError: a bug in an importer or a sink, never a defect of the
+ * input) propagates out of import() untouched, so no importer records this code any more; the
+ * constant stays for consumers that switch on the codes of earlier reports.
+ */
+export const PARSE_ERROR_CODE = "E_PARSE";
+/**
+ * Accumulates an ImportReport while an importer runs. Errors count toward the error limit; the
+ * error that takes the count beyond the limit is still recorded, `truncated` is set, and an
+ * ImportError carrying the report so far is thrown (design section 8.4: "beyond it the importer
+ * aborts with E_IMPORT"). Warnings never abort.
+ */
+export class ImportReportBuilder {
+    /**
+     * Create a builder for one import call.
+     * @param format - the importer's format name
+     * @param errorLimit - errors tolerated before the import aborts; Infinity for no limit
+     */
+    constructor(format, errorLimit) {
+        /** The element counters; importers increment them directly. */
+        this.counts = { nodes: 0, edges: 0, skippedNodes: 0, skippedEdges: 0, expandedMixed: 0 };
+        this.issueList = [];
+        this.lossList = [];
+        this.onceCodes = new Set();
+        this.errors = 0;
+        this.warnings = 0;
+        this.truncatedFlag = false;
+        this.format = format;
+        this.errorLimit = errorLimit;
+        this.startedAt = now();
+    }
+    /**
+     * Issues recorded so far, in order.
+     * @returns the live list (not copied; finish() copies)
+     */
+    get issues() {
+        return this.issueList;
+    }
+    /**
+     * Issues with severity "error".
+     * @returns the count
+     */
+    get errorCount() {
+        return this.errors;
+    }
+    /**
+     * Issues with severity "warning".
+     * @returns the count
+     */
+    get warningCount() {
+        return this.warnings;
+    }
+    /**
+     * Whether the error limit was exceeded.
+     * @returns true once an error beyond the limit was recorded
+     */
+    get truncated() {
+        return this.truncatedFlag;
+    }
+    /**
+     * Loss notes recorded so far.
+     * @returns the live list
+     */
+    get lossy() {
+        return this.lossList;
+    }
+    /**
+     * Record an error. When the count goes beyond the error limit the report is marked truncated
+     * and an ImportError carrying it is thrown; the importer does not catch that.
+     * @param category - the issue category
+     * @param code - a stable code such as "E_UNKNOWN_NODE"
+     * @param message - a plain-ASCII message
+     * @param where - the line and element, when known
+     * @returns the recorded issue
+     */
+    error(category, code, message, where) {
+        const issue = makeIssue(category, "error", code, message, where);
+        this.issueList.push(issue);
+        this.errors++;
+        if (this.errors > this.errorLimit) {
+            this.truncatedFlag = true;
+            throw this.abort(`error limit of ${this.errorLimit} exceeded: ${message}`, {
+                code,
+                limit: this.errorLimit,
+            });
+        }
+        return issue;
+    }
+    /**
+     * Record a warning; warnings never count toward the limit.
+     * @param category - the issue category
+     * @param code - a stable code such as "W_WIDENED"
+     * @param message - a plain-ASCII message
+     * @param where - the line and element, when known
+     * @returns the recorded issue
+     */
+    warning(category, code, message, where) {
+        const issue = makeIssue(category, "warning", code, message, where);
+        this.issueList.push(issue);
+        this.warnings++;
+        return issue;
+    }
+    /**
+     * Record a warning the first time its key is seen and ignore later repeats, for conditions
+     * that would otherwise produce one warning per row.
+     * @param category - the issue category
+     * @param code - the stable code
+     * @param message - a plain-ASCII message
+     * @param where - the line and element, when known
+     * @param key - what repeats are deduplicated on; the code itself by default (pass `code:column`
+     * to warn once per column)
+     * @returns the recorded issue, or null when the key was already recorded
+     */
+    warnOnce(category, code, message, where, key = code) {
+        if (this.onceCodes.has(key)) {
+            return null;
+        }
+        this.onceCodes.add(key);
+        return this.warning(category, code, message, where);
+    }
+    /**
+     * Record something the importer could not represent.
+     * @param code - a stable code
+     * @param message - a plain-ASCII message
+     * @param column - the affected column, or null
+     * @param count - the affected count, or null
+     * @returns the recorded note
+     */
+    loss(code, message, column = null, count = null) {
+        const note = Object.freeze({ code, message, column, count });
+        this.lossList.push(note);
+        return note;
+    }
+    /**
+     * The per-element catch of design section 8.6: record a thrown GraphFormatError as an error
+     * issue with its code and the category the code implies. Anything else is re-thrown unchanged:
+     * an ImportError (the import already aborted), an abort reason, and any other thrown value (a
+     * TypeError or RangeError is a programming error in the importer or the sink, never a defect of
+     * the input, so it must surface as an exception rather than as an issue blamed on the file).
+     * @param err - the thrown value
+     * @param where - the line and element, when known
+     * @returns the recorded issue
+     */
+    recordError(err, where) {
+        if (err instanceof GraphFormatError && !(err instanceof ImportError)) {
+            const category = CATEGORY_BY_CODE[err.code] ?? "validation-error";
+            return this.error(category, err.code, err.message, where);
+        }
+        throw err;
+    }
+    /**
+     * Build the ImportError that aborts the import, carrying the report so far. The caller throws
+     * it; this method only constructs it so it can be used in expression position.
+     * @param message - a plain-ASCII message
+     * @param details - optional machine-readable context
+     * @returns the error to throw
+     */
+    abort(message, details) {
+        return new ImportError(message, this.finish(), details);
+    }
+    /**
+     * Record a fatal parse error and abort: the issue is recorded (even beyond the error limit)
+     * and an ImportError carrying the report is thrown.
+     * @param code - a stable code such as "E_INVALID_UTF8"
+     * @param message - a plain-ASCII message
+     * @param where - the line and element, when known
+     * @param details - optional machine-readable context for the ImportError
+     */
+    fail(code, message, where, details) {
+        const issue = makeIssue("parse-error", "error", code, message, where);
+        this.issueList.push(issue);
+        this.errors++;
+        if (this.errors > this.errorLimit) {
+            this.truncatedFlag = true;
+        }
+        throw this.abort(message, { code, ...details });
+    }
+    /**
+     * The report as it stands: a frozen snapshot with the parse duration so far. Can be called more
+     * than once; each call reflects everything recorded up to that point.
+     * @returns the report
+     */
+    finish() {
+        const { nodes, edges, skippedNodes, skippedEdges, expandedMixed } = this.counts;
+        return Object.freeze({
+            format: this.format,
+            counts: Object.freeze({ nodes, edges, skippedNodes, skippedEdges, expandedMixed }),
+            issues: Object.freeze([...this.issueList]),
+            errorCount: this.errors,
+            warningCount: this.warnings,
+            truncated: this.truncatedFlag,
+            lossy: Object.freeze([...this.lossList]),
+            durationMs: now() - this.startedAt,
+        });
+    }
+}
+/**
+ * Build a frozen ImportIssue.
+ * @param category - the category
+ * @param severity - error or warning
+ * @param code - the stable code
+ * @param message - the message
+ * @param where - the location, when known
+ * @returns the issue
+ */
+function makeIssue(category, severity, code, message, where) {
+    return Object.freeze({
+        category,
+        severity,
+        code,
+        message,
+        line: where?.line ?? null,
+        element: where?.element ?? null,
+    });
+}
+/**
+ * Whether a thrown value is an abort reason (the DOMException or Error named "AbortError" that
+ * AbortSignal.reason holds), which an importer must let through untouched.
+ * @param err - the thrown value
+ * @returns true for an AbortError
+ */
+export function isAbortError(err) {
+    return typeof err === "object" && err !== null && err.name === "AbortError";
+}
+/**
+ * The message of a thrown value: an Error's message, a string as is, anything else described by type.
+ * @param err - the thrown value
+ * @returns a plain message
+ */
+export function messageOf(err) {
+    if (err instanceof Error) {
+        return err.message;
+    }
+    if (typeof err === "string") {
+        return err;
+    }
+    return `non-error thrown (${typeof err})`;
+}
+/**
+ * A monotonic millisecond clock: performance.now() where it exists, Date.now() otherwise.
+ * @returns milliseconds
+ */
+function now() {
+    return typeof performance === "object" ? performance.now() : Date.now();
+}
+//# sourceMappingURL=report.js.map

package/dist/src/common/report.js.map

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

package/dist/src/common/temporal.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Temporal values (design section 5.1): `date` / `dateTime` attributes, GEXF time bounds and Neo4j
+ * temporal types become f64 epoch milliseconds (or the raw numeric time when the file's timeformat
+ * is integer / double). When a value's canonical re-formatting would differ from the source text (a
+ * UTC offset, fractional seconds beyond milliseconds, a date without a time in a dateTime column)
+ * the importer also keeps the lexical form in a companion `<column>.text` column with role
+ * `timeText`; the exporter emits the text when present and formats the number otherwise.
+ *
+ * Only ISO-8601 forms are parsed (XSD date / dateTime / time and Neo4j's literals), by a fixed
+ * grammar rather than Date.parse, so two hosts agree on every value.
+ */
+import { type ColumnDecl, type ColumnRole } from "@graphty/graph-format";
+/** The temporal kinds a declared type can map to; each fixes the parse grammar and the canonical text. */
+export type TemporalKind = "date" | "dateTime" | "localDateTime" | "time" | "localTime";
+/**
+ * The GEXF `timeformat` values (design section 5.9).
+ * Consumed by the per-format importers and exporters under src/formats.
+ * @public
+ */
+export type TimeFormat = "integer" | "double" | "date" | "dateTime";
+/** A parsed temporal value: the number stored in the column and the source text when it must be kept. */
+export interface TemporalValue {
+    /** Epoch milliseconds (date, dateTime, localDateTime), milliseconds since midnight (time, localTime), or the raw number. */
+    readonly value: number;
+    /** The source text when formatTemporal(value) would not reproduce it; null otherwise. */
+    readonly text: string | null;
+}
+/** The role of a companion text column. */
+export declare const TIME_TEXT_ROLE: ColumnRole;
+/** The suffix of a companion text column's name. */
+export declare const TIME_TEXT_SUFFIX = ".text";
+/**
+ * Parse an ISO-8601 temporal text of one kind.
+ * @param text - the source text (already trimmed)
+ * @param kind - the temporal kind
+ * @returns the value and, when the canonical form differs, the source text; E_COLUMN_TYPE when the text is not of the kind
+ */
+export declare function parseTemporal(text: string, kind: TemporalKind): TemporalValue;
+/**
+ * Parse a GEXF time bound (`start`, `end`, `timestamp`, a spell or an attvalue time) under the
+ * graph's timeformat: integer / double values are numbers as written; date / dateTime values are
+ * ISO text; when the format is unknown (absent header) numeric text is a number and anything else
+ * is tried as dateTime.
+ * @param text - the source text
+ * @param timeFormat - the graph's timeformat, or null when the file declares none
+ * @returns the value and the source text when it must be kept
+ */
+export declare function parseTimeText(text: string, timeFormat: TimeFormat | null): TemporalValue;
+/**
+ * Format a temporal value in its canonical ISO-8601 form.
+ * @param value - the number as stored
+ * @param kind - the temporal kind
+ * @returns the canonical text: `YYYY-MM-DD`, `YYYY-MM-DDTHH:MM:SS[.mmm]Z`, `YYYY-MM-DDTHH:MM:SS[.mmm]`,
+ * `HH:MM:SS[.mmm]Z` or `HH:MM:SS[.mmm]`
+ */
+export declare function formatTemporal(value: number, kind: TemporalKind): string;
+/**
+ * Format a GEXF time bound under the graph's timeformat: the number's shortest text for integer /
+ * double, the canonical ISO form otherwise.
+ * @param value - the value as stored
+ * @param timeFormat - the graph's timeformat, or null for a file that declares none (double)
+ * @returns the text
+ */
+export declare function formatTimeValue(value: number, timeFormat: TimeFormat | null): string;
+/**
+ * The declaration of the companion text column of a temporal column (design section 5.1).
+ * @param column - the temporal column's name
+ * @returns a string column named `<column>.text` with role timeText and `extra.for` naming the column
+ */
+export declare function timeTextCompanion(column: string): ColumnDecl;
+//# sourceMappingURL=temporal.d.ts.map

package/dist/src/common/temporal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../../src/common/temporal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAoB,MAAM,uBAAuB,CAAC;AAE3F,0GAA0G;AAC1G,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,MAAM,GAAG,WAAW,CAAC;AAExF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAEpE,yGAAyG;AACzG,MAAM,WAAW,aAAa;IAC1B,4HAA4H;IAC5H,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,2CAA2C;AAC3C,eAAO,MAAM,cAAc,EAAE,UAAuB,CAAC;AAErD,oDAAoD;AACpD,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAUxC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,aAAa,CAmB7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,aAAa,CAiBxF;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CA2BxE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAepF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAQ5D"}

package/dist/src/common/temporal.js

@@ -0,0 +1,266 @@
+/**
+ * Temporal values (design section 5.1): `date` / `dateTime` attributes, GEXF time bounds and Neo4j
+ * temporal types become f64 epoch milliseconds (or the raw numeric time when the file's timeformat
+ * is integer / double). When a value's canonical re-formatting would differ from the source text (a
+ * UTC offset, fractional seconds beyond milliseconds, a date without a time in a dateTime column)
+ * the importer also keeps the lexical form in a companion `<column>.text` column with role
+ * `timeText`; the exporter emits the text when present and formats the number otherwise.
+ *
+ * Only ISO-8601 forms are parsed (XSD date / dateTime / time and Neo4j's literals), by a fixed
+ * grammar rather than Date.parse, so two hosts agree on every value.
+ */
+import { GraphFormatError } from "@graphty/graph-format";
+/** The role of a companion text column. */
+export const TIME_TEXT_ROLE = "timeText";
+/** The suffix of a companion text column's name. */
+export const TIME_TEXT_SUFFIX = ".text";
+const DATE_TIME = /^(-?[0-9]{4,})-([0-9]{2})-([0-9]{2})(?:[T ]([0-9]{2}):([0-9]{2})(?::([0-9]{2})(?:\.([0-9]{1,9}))?)?)?(Z|z|[+-][0-9]{2}(?::?[0-9]{2})?)?$/;
+const TIME = /^([0-9]{2}):([0-9]{2})(?::([0-9]{2})(?:\.([0-9]{1,9}))?)?(Z|z|[+-][0-9]{2}(?::?[0-9]{2})?)?$/;
+const NUMERIC = /^[+-]?([0-9]+(\.[0-9]*)?|\.[0-9]+)([eE][+-]?[0-9]+)?$/;
+const MS_PER_MINUTE = 60000;
+const MS_PER_DAY = 86400000;
+/**
+ * Parse an ISO-8601 temporal text of one kind.
+ * @param text - the source text (already trimmed)
+ * @param kind - the temporal kind
+ * @returns the value and, when the canonical form differs, the source text; E_COLUMN_TYPE when the text is not of the kind
+ */
+export function parseTemporal(text, kind) {
+    let value;
+    switch (kind) {
+        case "date":
+        case "dateTime":
+        case "localDateTime":
+            value = parseDateTime(text, kind);
+            break;
+        case "time":
+        case "localTime":
+            value = parseTime(text, kind);
+            break;
+        default: {
+            const name = kind;
+            throw new GraphFormatError("E_COLUMN_TYPE", `unknown temporal kind ${name}`, { kind: name });
+        }
+    }
+    const canonical = formatTemporal(value, kind);
+    return { value, text: canonical === text ? null : text };
+}
+/**
+ * Parse a GEXF time bound (`start`, `end`, `timestamp`, a spell or an attvalue time) under the
+ * graph's timeformat: integer / double values are numbers as written; date / dateTime values are
+ * ISO text; when the format is unknown (absent header) numeric text is a number and anything else
+ * is tried as dateTime.
+ * @param text - the source text
+ * @param timeFormat - the graph's timeformat, or null when the file declares none
+ * @returns the value and the source text when it must be kept
+ */
+export function parseTimeText(text, timeFormat) {
+    const trimmed = text.trim();
+    switch (timeFormat) {
+        case "integer":
+        case "double":
+            return parseNumericTime(trimmed);
+        case "date":
+            return parseTemporal(trimmed, "date");
+        case "dateTime":
+            return parseTemporal(trimmed, "dateTime");
+        case null:
+            return NUMERIC.test(trimmed) ? parseNumericTime(trimmed) : parseTemporal(trimmed, "dateTime");
+        default: {
+            const name = timeFormat;
+            throw new GraphFormatError("E_COLUMN_TYPE", `unknown timeformat ${name}`, { timeFormat: name });
+        }
+    }
+}
+/**
+ * Format a temporal value in its canonical ISO-8601 form.
+ * @param value - the number as stored
+ * @param kind - the temporal kind
+ * @returns the canonical text: `YYYY-MM-DD`, `YYYY-MM-DDTHH:MM:SS[.mmm]Z`, `YYYY-MM-DDTHH:MM:SS[.mmm]`,
+ * `HH:MM:SS[.mmm]Z` or `HH:MM:SS[.mmm]`
+ */
+export function formatTemporal(value, kind) {
+    switch (kind) {
+        case "date": {
+            const d = new Date(value);
+            return `${year(d)}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+        }
+        case "dateTime":
+        case "localDateTime": {
+            const d = new Date(value);
+            const date = `${year(d)}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())}`;
+            const time = clock(d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds(), d.getUTCMilliseconds());
+            return kind === "dateTime" ? `${date}T${time}Z` : `${date}T${time}`;
+        }
+        case "time":
+        case "localTime": {
+            const ms = ((value % MS_PER_DAY) + MS_PER_DAY) % MS_PER_DAY;
+            const h = Math.floor(ms / 3600000);
+            const m = Math.floor((ms % 3600000) / MS_PER_MINUTE);
+            const s = Math.floor((ms % MS_PER_MINUTE) / 1000);
+            const text = clock(h, m, s, ms % 1000);
+            return kind === "time" ? `${text}Z` : text;
+        }
+        default: {
+            const name = kind;
+            throw new GraphFormatError("E_COLUMN_TYPE", `unknown temporal kind ${name}`, { kind: name });
+        }
+    }
+}
+/**
+ * Format a GEXF time bound under the graph's timeformat: the number's shortest text for integer /
+ * double, the canonical ISO form otherwise.
+ * @param value - the value as stored
+ * @param timeFormat - the graph's timeformat, or null for a file that declares none (double)
+ * @returns the text
+ */
+export function formatTimeValue(value, timeFormat) {
+    switch (timeFormat) {
+        case "date":
+            return formatTemporal(value, "date");
+        case "dateTime":
+            return formatTemporal(value, "dateTime");
+        case "integer":
+        case "double":
+        case null:
+            return String(value);
+        default: {
+            const name = timeFormat;
+            throw new GraphFormatError("E_COLUMN_TYPE", `unknown timeformat ${name}`, { timeFormat: name });
+        }
+    }
+}
+/**
+ * The declaration of the companion text column of a temporal column (design section 5.1).
+ * @param column - the temporal column's name
+ * @returns a string column named `<column>.text` with role timeText and `extra.for` naming the column
+ */
+export function timeTextCompanion(column) {
+    return {
+        name: column + TIME_TEXT_SUFFIX,
+        dtype: "string",
+        role: TIME_TEXT_ROLE,
+        nullable: true,
+        extra: { for: column },
+    };
+}
+/**
+ * Parse a numeric time bound.
+ * @param text - the trimmed source text
+ * @returns the number; the text is kept when String(value) differs from it
+ */
+function parseNumericTime(text) {
+    if (!NUMERIC.test(text)) {
+        throw new GraphFormatError("E_COLUMN_TYPE", `"${text}" is not a numeric time`, { value: text });
+    }
+    const value = Number(text);
+    return { value, text: String(value) === text ? null : text };
+}
+/**
+ * Parse a date or date-time text into epoch milliseconds.
+ * @param text - the source text
+ * @param kind - date (a time part is accepted and kept in the companion), dateTime or localDateTime
+ * @returns epoch milliseconds
+ */
+function parseDateTime(text, kind) {
+    const m = DATE_TIME.exec(text);
+    if (m === null) {
+        throw new GraphFormatError("E_COLUMN_TYPE", `"${text}" is not an ISO-8601 ${kind}`, { value: text, kind });
+    }
+    const y = Number(m[1]);
+    const month = Number(m[2]);
+    const day = Number(m[3]);
+    const hour = m[4] === undefined ? 0 : Number(m[4]);
+    const minute = m[5] === undefined ? 0 : Number(m[5]);
+    const second = m[6] === undefined ? 0 : Number(m[6]);
+    const ms = m[7] === undefined ? 0 : fractionMs(m[7]);
+    if (month < 1 || month > 12 || day < 1 || day > 31 || hour > 24 || minute > 59 || second > 60) {
+        throw new GraphFormatError("E_COLUMN_TYPE", `"${text}" is out of range for a ${kind}`, { value: text, kind });
+    }
+    // Date.UTC maps years 0..99 to 1900..1999; the setters do not
+    const d = new Date(0);
+    d.setUTCFullYear(y, month - 1, day);
+    d.setUTCHours(hour, minute, second, ms);
+    if (d.getUTCDate() !== day && hour !== 24) {
+        throw new GraphFormatError("E_COLUMN_TYPE", `"${text}" is not a calendar date`, { value: text, kind });
+    }
+    const offset = m[8] === undefined ? 0 : offsetMinutes(m[8]);
+    return d.getTime() - offset * MS_PER_MINUTE;
+}
+/**
+ * Parse a time-of-day text into milliseconds since midnight (UTC for `time` with a zone).
+ * @param text - the source text
+ * @param kind - time or localTime
+ * @returns milliseconds since midnight in 0..86400000
+ */
+function parseTime(text, kind) {
+    const m = TIME.exec(text);
+    if (m === null) {
+        throw new GraphFormatError("E_COLUMN_TYPE", `"${text}" is not an ISO-8601 ${kind}`, { value: text, kind });
+    }
+    const hour = Number(m[1]);
+    const minute = Number(m[2]);
+    const second = m[3] === undefined ? 0 : Number(m[3]);
+    const ms = m[4] === undefined ? 0 : fractionMs(m[4]);
+    if (hour > 24 || minute > 59 || second > 60) {
+        throw new GraphFormatError("E_COLUMN_TYPE", `"${text}" is out of range for a ${kind}`, { value: text, kind });
+    }
+    const local = ((hour * 60 + minute) * 60 + second) * 1000 + ms;
+    const offset = m[5] === undefined ? 0 : offsetMinutes(m[5]);
+    const utc = local - offset * MS_PER_MINUTE;
+    return ((utc % MS_PER_DAY) + MS_PER_DAY) % MS_PER_DAY;
+}
+/**
+ * Milliseconds of a fractional-second text (1 to 9 digits), truncated to whole milliseconds.
+ * @param digits - the digits after the decimal point
+ * @returns 0..999
+ */
+function fractionMs(digits) {
+    return Math.floor(Number(`0.${digits}`) * 1000);
+}
+/**
+ * The minutes of a zone designator.
+ * @param zone - "Z", "+HH:MM", "+HHMM" or "+HH"
+ * @returns signed minutes east of UTC
+ */
+function offsetMinutes(zone) {
+    if (zone === "Z" || zone === "z") {
+        return 0;
+    }
+    const sign = zone.startsWith("-") ? -1 : 1;
+    const digits = zone.slice(1).replace(":", "");
+    const hours = Number(digits.slice(0, 2));
+    const minutes = digits.length > 2 ? Number(digits.slice(2, 4)) : 0;
+    return sign * (hours * 60 + minutes);
+}
+/**
+ * Two-digit zero-padded text.
+ * @param n - 0..99
+ * @returns the text
+ */
+function pad2(n) {
+    return n < 10 ? `0${n}` : String(n);
+}
+/**
+ * The year of a UTC date as at least four digits (negative years keep their sign).
+ * @param d - the date
+ * @returns the text
+ */
+function year(d) {
+    const y = d.getUTCFullYear();
+    const abs = String(Math.abs(y)).padStart(4, "0");
+    return y < 0 ? `-${abs}` : abs;
+}
+/**
+ * `HH:MM:SS` with `.mmm` appended when the milliseconds are not zero.
+ * @param h - hours
+ * @param m - minutes
+ * @param s - seconds
+ * @param ms - milliseconds
+ * @returns the text
+ */
+function clock(h, m, s, ms) {
+    const base = `${pad2(h)}:${pad2(m)}:${pad2(s)}`;
+    return ms === 0 ? base : `${base}.${String(ms).padStart(3, "0")}`;
+}
+//# sourceMappingURL=temporal.js.map

package/dist/src/common/temporal.js.map

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