@graphty/graph-io 0.0.0 → 0.2.0

package/dist/src/sniff.js

@@ -0,0 +1,357 @@
+/**
+ * Format detection (design sections 8.2 and 13.1: the registry's `sniff()`, the successor of
+ * graphty-element's `format-detection.ts`): which of the registered importers a file is for, from
+ * any combination of a filename (its extension), a MIME type and the first bytes of the content.
+ *
+ * Every importer declares `extensions`, `mimeTypes` and a `sniff(head)` content confidence in
+ * 0..1 (design section 8.4); this module combines them into one ranked answer so that content
+ * always beats a hint: a `.csv` whose first line is a neo4j-admin header is Neo4j, a `.xml` is
+ * GEXF or GraphML by its root element, a `.txt` holding `graph [` is GML. The confidence of a
+ * candidate is
+ *
+ * - `0.5 + 0.35 * content + 0.1 * [extension matches] + 0.05 * [MIME type matches]` when the
+ *   importer recognises the content (`content > 0`), so a content match always scores at least
+ *   0.5 and at most 1;
+ * - `0.3 * [extension matches] + 0.1 * [MIME type matches]` when the content is absent or the
+ *   importer rejects it, so a hint alone never reaches 0.5;
+ * - nothing (the format is not a candidate) otherwise.
+ *
+ * Ties are broken by the order the importers were registered in, which is why the default
+ * registry lists the common formats first. The JSON dialect is sniffed from the head as a hint
+ * (the importer's detection on the parsed document is authoritative, design section 8.2).
+ */
+import { sniffJsonDialect } from "./formats/json/dialect.js";
+/**
+ * The built-in format names in the default registry's order, which is also the tie-break order of
+ * sniffing: the more common format wins an extension two formats claim (`.xml` GraphML before GEXF,
+ * `.csv` CSV before Neo4j) when the content does not decide.
+ */
+export const GRAPH_FORMATS = Object.freeze([
+    "json",
+    "graphml",
+    "gexf",
+    "csv",
+    "gml",
+    "dot",
+    "pajek",
+    "neo4j",
+]);
+/** How many bytes of the input the sniffers look at; the registry reads no more than this before deciding. */
+export const SNIFF_HEAD_BYTES = 8192;
+/**
+ * The lower-cased extension of a file name or path, with its dot.
+ * @param filename - the name or path
+ * @returns the extension (`.gexf`), or null when the name has none
+ */
+export function extensionOf(filename) {
+    const base = filename.slice(Math.max(filename.lastIndexOf("/"), filename.lastIndexOf("\\")) + 1);
+    const dot = base.lastIndexOf(".");
+    if (dot <= 0 || dot === base.length - 1) {
+        return null;
+    }
+    return base.slice(dot).toLowerCase();
+}
+/**
+ * A MIME type without parameters, lower-cased, for comparison with an importer's list.
+ * @param mimeType - the type as received (`Text/CSV; charset=utf-8`)
+ * @returns the bare type (`text/csv`)
+ */
+export function normalizeMimeType(mimeType) {
+    const semicolon = mimeType.indexOf(";");
+    return (semicolon < 0 ? mimeType : mimeType.slice(0, semicolon)).trim().toLowerCase();
+}
+/**
+ * The head as bytes for the importers' sniff functions: at most SNIFF_HEAD_BYTES, a string
+ * encoded as UTF-8.
+ * @param head - the head as given
+ * @returns the bytes
+ */
+export function headBytes(head) {
+    if (typeof head === "string") {
+        return new TextEncoder().encode(head.slice(0, SNIFF_HEAD_BYTES)).subarray(0, SNIFF_HEAD_BYTES);
+    }
+    return head.byteLength > SNIFF_HEAD_BYTES ? head.subarray(0, SNIFF_HEAD_BYTES) : head;
+}
+/**
+ * Rank the registered importers for an input by the rule of the module comment: every importer
+ * whose content confidence is positive or whose extension / MIME type matches is a candidate,
+ * ordered by confidence (ties in registration order).
+ * @param hints - what is known about the input
+ * @param importers - the registered importers, in registration order
+ * @returns the candidates, best first; empty when nothing matches
+ */
+export function rankFormats(hints, importers) {
+    const extension = typeof hints.filename === "string" ? extensionOf(hints.filename) : null;
+    const mime = typeof hints.mimeType === "string" ? normalizeMimeType(hints.mimeType) : null;
+    const head = hints.head === undefined || hints.head === null ? null : headBytes(hints.head);
+    const candidates = [];
+    let rank = 0;
+    for (const importer of importers) {
+        const extensionMatch = extension !== null && importer.extensions.some((e) => e.toLowerCase() === extension);
+        const mimeMatch = mime !== null && importer.mimeTypes.some((m) => m.toLowerCase() === mime);
+        let content = 0;
+        if (head !== null && head.byteLength > 0 && typeof importer.sniff === "function") {
+            content = clamp(importer.sniff(head));
+        }
+        let confidence;
+        if (content > 0) {
+            confidence = 0.5 + 0.35 * content + (extensionMatch ? 0.1 : 0) + (mimeMatch ? 0.05 : 0);
+        }
+        else if (extensionMatch || mimeMatch) {
+            confidence = (extensionMatch ? 0.3 : 0) + (mimeMatch ? 0.1 : 0);
+        }
+        else {
+            continue;
+        }
+        const dialect = importer.format === "json" && head !== null ? sniffJsonDialectHead(head) : null;
+        const result = Object.freeze({
+            format: importer.format,
+            confidence: Math.min(1, confidence),
+            content,
+            extension: extensionMatch,
+            mimeType: mimeMatch,
+            dialect,
+        });
+        candidates.push({ result, rank: rank++ });
+    }
+    candidates.sort((a, b) => b.result.confidence - a.result.confidence || a.rank - b.rank);
+    return candidates.map((c) => c.result);
+}
+/**
+ * The best candidate of rankFormats(), or null when no importer matches.
+ * @param hints - what is known about the input
+ * @param importers - the registered importers, in registration order
+ * @returns the best candidate, or null
+ */
+export function sniffFormat(hints, importers) {
+    const ranked = rankFormats(hints, importers);
+    return ranked.length > 0 ? ranked[0] : null;
+}
+/**
+ * The JSON dialect a head suggests. A head that parses as a whole document is classified exactly
+ * (sniffJsonDialect); a truncated head is scanned for its top-level keys, the keys of `graph` and
+ * `options`, and the keys of the first object under `nodes` / `edges` / `links`, and the same
+ * rule is applied to that skeleton. The result is a hint: the importer decides on the parsed
+ * document.
+ * @param head - the first bytes or characters of the document
+ * @returns the dialect, or null when the head is not a JSON graph document
+ */
+export function sniffJsonDialectHead(head) {
+    const text = typeof head === "string" ? head : new TextDecoder("utf-8", { fatal: false }).decode(head);
+    const body = text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+    const trimmed = body.trimStart();
+    if (!trimmed.startsWith("{") && !trimmed.startsWith("[")) {
+        return null;
+    }
+    let root;
+    try {
+        root = JSON.parse(trimmed);
+    }
+    catch {
+        root = skeletonOf(trimmed);
+    }
+    return sniffJsonDialect(root);
+}
+/**
+ * A partial document rebuilt from the keys a truncated head reveals: every key gets a placeholder
+ * value of the shape the dialect rule tests for (an object for `graph`, `options`, `attributes`
+ * and `data`, an array holding the first element's skeleton for `nodes` / `edges` / `links` /
+ * `graphs`, `true` otherwise), so sniffJsonDialect() can classify it.
+ * @param text - the head, starting with `{` or `[`
+ * @returns the skeleton, or null when the scan finds no key at all
+ */
+function skeletonOf(text) {
+    const keys = scanKeys(text);
+    if (text.startsWith("[")) {
+        // a cut array whose first element has not been seen tells nothing (a whole `[]` is Cytoscape)
+        const first = keys.get("nodes[0]");
+        return first === undefined ? null : [objectOf(first)];
+    }
+    const rootKeys = keys.get("");
+    if (rootKeys === undefined) {
+        return null;
+    }
+    const root = {};
+    for (const key of rootKeys) {
+        switch (key) {
+            case "graph":
+            case "options":
+                root[key] = objectOf(keys.get(key));
+                break;
+            case "graphs":
+                root[key] = [];
+                break;
+            case "nodes":
+            case "edges":
+            case "links": {
+                const first = keys.get(`${key}[0]`);
+                root[key] = first === undefined ? [] : [objectOf(first)];
+                break;
+            }
+            default:
+                root[key] = true;
+                break;
+        }
+    }
+    return root;
+}
+/**
+ * An object holding placeholder values for a key set: `{}` for the keys the rule tests with
+ * isJsonObject (`attributes`, `data`), `true` otherwise.
+ * @param names - the keys, possibly undefined
+ * @returns the object
+ */
+function objectOf(names) {
+    const out = {};
+    if (names !== undefined) {
+        for (const name of names) {
+            out[name] = name === "attributes" || name === "data" ? {} : true;
+        }
+    }
+    return out;
+}
+/**
+ * Scan a (possibly truncated) JSON text for the keys at the paths the dialect rule reads. The
+ * scanner tracks a container stack (the key each object sits under, the index of each array
+ * element) and records a key when it is at one of the watched paths; a head cut inside a string
+ * or a number simply ends the scan. For a top-level array the first element's keys are recorded
+ * under `nodes[0]`.
+ * @param text - the head, starting with `{` or `[`
+ * @returns key sets by path
+ */
+function scanKeys(text) {
+    const found = new Map();
+    // one frame per open container: its kind, the key or index it sits under, and the element index
+    const kinds = [];
+    const labels = [];
+    const counts = [];
+    let pendingKey = null;
+    let expectingKey = false;
+    const pathOf = () => {
+        const depth = kinds.length;
+        if (depth === 1) {
+            return kinds[0] === "object" ? "" : null;
+        }
+        if (depth === 2 && kinds[0] === "array" && kinds[1] === "object" && labels[1] === "0") {
+            return "nodes[0]";
+        }
+        if (depth === 2 && kinds[0] === "object" && kinds[1] === "object") {
+            return labels[1] === "graph" || labels[1] === "options" ? labels[1] : null;
+        }
+        if (depth === 3 && kinds[0] === "object" && kinds[1] === "array" && kinds[2] === "object") {
+            const section = labels[1];
+            if ((section === "nodes" || section === "edges" || section === "links") && labels[2] === "0") {
+                return `${section}[0]`;
+            }
+        }
+        return null;
+    };
+    let i = 0;
+    const n = text.length;
+    while (i < n) {
+        const ch = text[i];
+        if (ch === '"') {
+            const end = scanString(text, i + 1);
+            if (end < 0) {
+                break;
+            }
+            const literal = text.slice(i + 1, end);
+            i = end + 1;
+            if (expectingKey) {
+                pendingKey = decodeKey(literal);
+                expectingKey = false;
+            }
+            continue;
+        }
+        if (ch === "{" || ch === "[") {
+            let label = "";
+            if (kinds.length > 0) {
+                label = kinds[kinds.length - 1] === "object" ? (pendingKey ?? "") : String(counts[counts.length - 1]);
+            }
+            kinds.push(ch === "{" ? "object" : "array");
+            labels.push(label);
+            counts.push(0);
+            expectingKey = ch === "{";
+            pendingKey = null;
+        }
+        else if (ch === "}" || ch === "]") {
+            kinds.pop();
+            labels.pop();
+            counts.pop();
+            expectingKey = false;
+            pendingKey = null;
+        }
+        else if (ch === ":") {
+            if (pendingKey !== null) {
+                const path = pathOf();
+                if (path !== null) {
+                    let set = found.get(path);
+                    if (set === undefined) {
+                        set = new Set();
+                        found.set(path, set);
+                    }
+                    set.add(pendingKey);
+                }
+            }
+        }
+        else if (ch === ",") {
+            const top = kinds.length - 1;
+            if (top >= 0) {
+                counts[top]++;
+                expectingKey = kinds[top] === "object";
+            }
+            pendingKey = null;
+        }
+        i++;
+    }
+    return found;
+}
+/**
+ * The index of the closing quote of a JSON string starting after its opening quote.
+ * @param text - the text
+ * @param from - the index after the opening quote
+ * @returns the index of the closing quote, or -1 when the text ends first
+ */
+function scanString(text, from) {
+    let i = from;
+    while (i < text.length) {
+        const ch = text[i];
+        if (ch === "\\") {
+            i += 2;
+            continue;
+        }
+        if (ch === '"') {
+            return i;
+        }
+        i++;
+    }
+    return -1;
+}
+/**
+ * A key literal decoded when it holds escapes, kept as written otherwise.
+ * @param literal - the text between the quotes
+ * @returns the key
+ */
+function decodeKey(literal) {
+    if (!literal.includes("\\")) {
+        return literal;
+    }
+    try {
+        return JSON.parse(`"${literal}"`);
+    }
+    catch {
+        return literal;
+    }
+}
+/**
+ * Coerce a sniff confidence into 0..1 (NaN counts as 0).
+ * @param value - the importer's answer
+ * @returns the clamped value
+ */
+function clamp(value) {
+    if (!(value > 0)) {
+        return 0;
+    }
+    return value > 1 ? 1 : value;
+}
+//# sourceMappingURL=sniff.js.map

package/dist/src/sniff.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,238 @@
+/**
+ * The io contract types of @graphty/graph-io (design section 12.4, normative): what every importer
+ * and exporter implements and what every caller of one programs against. They are declared here
+ * rather than in the core because ImportInput and CommonImportOptions reference ReadableStream and
+ * AbortSignal, which need the DOM lib (or @types/node >= 18); the core's public types reference only
+ * ES2020 globals (decision D-IO-TYPES). Every declaration is transcribed verbatim from the design;
+ * the behaviour behind each option is specified in sections 8.4 (import), 8.5 (export) and 8.6
+ * (report and error aggregation).
+ */
+import { type Dtype, type DuplicatePolicy, GraphFormatError, type GraphSink, type GraphSnapshot, type IdCoercion } from "@graphty/graph-format";
+/**
+ * What an importer reads (design section 8.4): whole text, whole bytes, a byte stream (a browser
+ * `File.stream()`, a fetch body) or an async iterable of text or byte chunks. Bytes are decoded as
+ * UTF-8 with `fatal: true`, so an invalid sequence is a parse-error and never a silent U+FFFD that
+ * could alias two ids.
+ */
+export type ImportInput = string | Uint8Array | ReadableStream<Uint8Array> | AsyncIterable<string | Uint8Array>;
+/**
+ * The options every importer accepts next to its format-specific ones (design section 8.4). The
+ * builder-policy fields (`addMissingNodes`, `duplicateEdges`, `selfLoops`, `weightDtype`) seed the
+ * registry's builder; on a caller's sink they are read back from `sink.options` and every option the
+ * sink cannot honour is reported.
+ */
+export interface CommonImportOptions {
+    /**
+     * Id coercion rule applied before an id reaches the sink (design section 4.1): "canonical" by default for
+     * text-cell formats, "keep" for JSON.
+     */
+    ids?: IdCoercion | undefined;
+    /** Which field becomes the node id; "id" by default; "label" / "index" resolve the GML / Pajek / d3 ambiguity. */
+    nodeIdFrom?: "id" | "label" | "index" | undefined;
+    /** Whether an edge may reference an undeclared node (default true; the GEXF importer defaults false for edges). */
+    addMissingNodes?: boolean | undefined;
+    /** The builder's duplicate-edge policy seed; default "keep". */
+    duplicateEdges?: DuplicatePolicy | undefined;
+    /** The builder's self-loop policy seed; default "keep". */
+    selfLoops?: "keep" | "drop" | "error" | undefined;
+    /** What to do with a file whose edges disagree on direction (design section 3.6); default "expand". */
+    onMixedDirection?: "expand" | "directed" | "undirected" | "error" | undefined;
+    /** The direction assumed for a file that declares none (GEXF: undirected per spec). */
+    defaultDirected?: boolean | undefined;
+    /** The attribute that becomes THE weight (per-format default: "weight", GML "value"); null = unweighted. */
+    weightFrom?: string | null | undefined;
+    /** Weight staging precision; "f64" for every importer by default so 0.1 and 16777217 survive. */
+    weightDtype?: "f32" | "f64" | undefined;
+    /** How a declared `long` column is stored: "f64" (default) or "string" (design section 5.1). */
+    long?: "f64" | "string" | undefined;
+    /** Restore ids mangled by sanitizeIds "mangle" from the graphty:originalId attribute (default true). */
+    restoreMangledIds?: boolean | undefined;
+    /** GraphML / JGF hyperedges: refuse, skip with a report entry (default), or expand to a star / clique. */
+    hyperedges?: "error" | "skip" | "star" | "clique" | undefined;
+    /** Errors tolerated before the importer aborts with E_IMPORT (default 100). */
+    errorLimit?: number | undefined;
+    /** Cancellation; the importer stops between chunks and rejects with the signal's reason. */
+    signal?: AbortSignal | undefined;
+    /** Progress in bytes; `bytesTotal` is known for in-memory input only. */
+    onProgress?: ((bytesDone: number, bytesTotal?: number) => void) | undefined;
+}
+/**
+ * An importer plugin (design section 8.4): pushes scalars into the caller's sink in one pass and
+ * never freezes. `Opts` is its format-specific option set; the default `unknown` lets a caller pass
+ * the common options to an importer typed without one.
+ */
+export interface GraphImporter<Opts = unknown> {
+    /** The format name: "gexf", "graphml", "gml", "dot", "pajek", "csv", "json", "neo4j". */
+    readonly format: string;
+    /** File extensions with the leading dot. */
+    readonly extensions: readonly string[];
+    /** MIME types the format is served as. */
+    readonly mimeTypes: readonly string[];
+    /**
+     * Confidence that `head` is this format, for the registry's sniff().
+     * @param head - the first bytes of the input
+     * @returns a confidence in 0..1
+     */
+    sniff?(head: Uint8Array): number;
+    /**
+     * Read `input` into `sink`; per-element errors are aggregated into the report until the error
+     * limit, then the importer throws ImportError with the partial report.
+     * @param input - the text, bytes or stream to read
+     * @param sink - the builder (or a recording sink) to push into
+     * @param options - format-specific and common options
+     * @returns the import report
+     */
+    import(input: ImportInput, sink: GraphSink, options?: Opts & CommonImportOptions): Promise<ImportReport>;
+}
+/**
+ * What a format can express without loss (design section 8.5): the fidelity matrix of research
+ * note 07 section 9 as a table, and the acceptance test list for check().
+ */
+export interface ExportCapabilities {
+    /** Directed and undirected edges in one file. */
+    readonly mixedDirection: boolean;
+    /** Parallel edges. */
+    readonly multiEdges: boolean;
+    /** Self-loops. */
+    readonly selfLoops: boolean;
+    /** Whether edge ids are required (generated when absent), optional or unsupported. */
+    readonly edgeIds: "required" | "optional" | "none";
+    /** Which node ids can be written unchanged. */
+    readonly idCharset: "any" | "nmtoken" | "integer" | "dense-1-based";
+    /** The column dtypes the format keeps as declared. */
+    readonly dtypes: readonly Dtype[];
+    /** Multi-component (stride) columns. */
+    readonly components: boolean;
+    /** List columns. */
+    readonly lists: boolean;
+    /** Nested json columns. */
+    readonly json: boolean;
+    /** Declared defaults. */
+    readonly defaults: boolean;
+    /** Declared enumerations (GEXF options). */
+    readonly options: boolean;
+    /** Containment (parent / parents roles). */
+    readonly hierarchy: boolean;
+    /** Temporal support level. */
+    readonly temporal: "none" | "intervals" | "spells" | "dynamic-values";
+    /** Graph-level attributes. */
+    readonly graphAttributes: boolean;
+    /** The position role. */
+    readonly positions: boolean;
+    /** The visual roles (color, size, shape, thickness). */
+    readonly viz: boolean;
+}
+/** One thing an exporter cannot represent, reported by check() before anything is written (design section 8.5). */
+export interface LossNote {
+    /** A stable code such as "W_OPEN_INTERVAL". */
+    readonly code: string;
+    /** A plain-ASCII human-readable explanation. */
+    readonly message: string;
+    /** The affected column, or null when the note is not about a column. */
+    readonly column: string | null;
+    /** How many rows or elements are affected, or null when not counted. */
+    readonly count: number | null;
+}
+/** The options every exporter accepts next to its format-specific ones (design section 8.5). */
+export interface CommonExportOptions {
+    /** "error" (default): never rename a node; "mangle": rewrite ids the format cannot hold and keep the original. */
+    sanitizeIds?: "error" | "mangle" | undefined;
+    /** For formats without mixed-direction support: refuse (default) or write every edge one way. */
+    onMixedDirection?: "error" | "directed" | "undirected" | undefined;
+}
+/**
+ * An exporter plugin (design section 8.5): iterates nodes and logical edges (never arcs) in index
+ * order and reads the role columns of section 3.6 / 3.7 to fold expanded pairs and emit explicit
+ * weights only.
+ */
+export interface GraphExporter<Opts = unknown> {
+    /** The format name. */
+    readonly format: string;
+    /** What the format can express. */
+    readonly capabilities: ExportCapabilities;
+    /**
+     * Pre-flight: what export() would lose, without writing anything.
+     * @param snapshot - the snapshot to check
+     * @param options - format-specific and common options
+     * @returns the loss notes, empty when the export is exact
+     */
+    check(snapshot: GraphSnapshot, options?: Opts & CommonExportOptions): readonly LossNote[];
+    /**
+     * Write the snapshot as UTF-8 chunks.
+     * @param snapshot - the snapshot to write
+     * @param options - format-specific and common options
+     * @returns the encoded chunks
+     */
+    export(snapshot: GraphSnapshot, options?: Opts & CommonExportOptions): AsyncIterable<Uint8Array>;
+    /**
+     * Write the snapshot as one string.
+     * @param snapshot - the snapshot to write
+     * @param options - format-specific and common options
+     * @returns the whole document
+     */
+    exportToString(snapshot: GraphSnapshot, options?: Opts & CommonExportOptions): Promise<string>;
+}
+/** The categories of an ImportIssue (design section 8.6). */
+export type IssueCategory = "parse-error" | "missing-value" | "validation-error" | "unsupported" | "precision" | "coercion" | "merged";
+/** One problem found while importing (design section 8.6). */
+export interface ImportIssue {
+    /** The category. */
+    readonly category: IssueCategory;
+    /** Errors count toward the error limit; warnings do not. */
+    readonly severity: "error" | "warning";
+    /** A stable code such as "E_UNKNOWN_NODE" or "W_WIDENED". */
+    readonly code: string;
+    /** A plain-ASCII human-readable message. */
+    readonly message: string;
+    /** The 1-based source line, or null when unknown. */
+    readonly line: number | null;
+    /** The element (a node or edge id, an attribute name), or null when unknown. */
+    readonly element: string | null;
+}
+/** What an import produced besides the sink's contents (design section 8.6). */
+export interface ImportReport {
+    /** The importer's format name. */
+    readonly format: string;
+    /** Element counts. */
+    readonly counts: {
+        /** Nodes pushed. */
+        readonly nodes: number;
+        /** Logical edges pushed (both halves of an expanded edge count). */
+        readonly edges: number;
+        /** Nodes skipped after an error. */
+        readonly skippedNodes: number;
+        /** Edges skipped after an error. */
+        readonly skippedEdges: number;
+        /** Edges expanded under onMixedDirection "expand" (design section 3.6). */
+        readonly expandedMixed: number;
+    };
+    /** Every issue recorded, in order. */
+    readonly issues: readonly ImportIssue[];
+    /** Issues with severity "error". */
+    readonly errorCount: number;
+    /** Issues with severity "warning". */
+    readonly warningCount: number;
+    /** Whether the error limit was reached and the import aborted. */
+    readonly truncated: boolean;
+    /** What the importer could not represent. */
+    readonly lossy: readonly LossNote[];
+    /** Wall time of the parse phase; the caller's freeze reports separately. */
+    readonly durationMs: number;
+}
+/**
+ * The error an importer throws when the error limit is reached or the input cannot be read at all
+ * (design section 8.6): a GraphFormatError with code "E_IMPORT" (reserved in the core's union so
+ * `err.code === "E_IMPORT"` narrows) carrying the partial report.
+ */
+export declare class ImportError extends GraphFormatError {
+    /** The report as it stood when the import aborted. */
+    readonly report: ImportReport;
+    /**
+     * Create an ImportError.
+     * @param message - a plain-ASCII human-readable message
+     * @param report - the partial report
+     * @param details - optional machine-readable context
+     */
+    constructor(message: string, report: ImportReport, details?: Readonly<Record<string, unknown>>);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

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

package/dist/src/types.js

@@ -0,0 +1,29 @@
+/**
+ * The io contract types of @graphty/graph-io (design section 12.4, normative): what every importer
+ * and exporter implements and what every caller of one programs against. They are declared here
+ * rather than in the core because ImportInput and CommonImportOptions reference ReadableStream and
+ * AbortSignal, which need the DOM lib (or @types/node >= 18); the core's public types reference only
+ * ES2020 globals (decision D-IO-TYPES). Every declaration is transcribed verbatim from the design;
+ * the behaviour behind each option is specified in sections 8.4 (import), 8.5 (export) and 8.6
+ * (report and error aggregation).
+ */
+import { GraphFormatError, } from "@graphty/graph-format";
+/**
+ * The error an importer throws when the error limit is reached or the input cannot be read at all
+ * (design section 8.6): a GraphFormatError with code "E_IMPORT" (reserved in the core's union so
+ * `err.code === "E_IMPORT"` narrows) carrying the partial report.
+ */
+export class ImportError extends GraphFormatError {
+    /**
+     * Create an ImportError.
+     * @param message - a plain-ASCII human-readable message
+     * @param report - the partial report
+     * @param details - optional machine-readable context
+     */
+    constructor(message, report, details) {
+        super("E_IMPORT", message, details);
+        this.name = "ImportError";
+        this.report = report;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAGH,gBAAgB,GAInB,MAAM,uBAAuB,CAAC;AAgO/B;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,gBAAgB;IAI7C;;;;;OAKG;IACH,YAAY,OAAe,EAAE,MAAoB,EAAE,OAA2C;QAC1F,KAAK,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;CACJ"}