@graphty/graph-io 0.3.19 → 0.3.20

package/dist/src/common/zip.js

@@ -0,0 +1,399 @@
+/**
+ * A zip reader with no dependency (design `design/graph-io/cytoscape-and-obo/design.md` section
+ * 3.3; PKWARE APPNOTE 6.3.10, https://pkware.cachefly.net/webdocs/casestudies/APPNOTE.TXT), for
+ * the Cytoscape session importer.
+ *
+ * The whole archive is in memory: every Cytoscape-written entry has a data descriptor and zero
+ * sizes in its local header, so the sizes come from the central directory at the end. The end
+ * record is searched in the last 65,557 bytes (a comment can be 65,535 bytes long); the zip64
+ * locator and the `0x0001` extra field are followed; bytes prepended to the archive (a
+ * self-extracting stub) are tolerated by the shift between the directory's stated and actual
+ * offsets. Deflate (method 8) is inflated by wrapping the raw deflate bytes in a gzip member
+ * (header, data, the directory's CRC-32 and size) and passing it to `DecompressionStream("gzip")`,
+ * which every supported runtime has (Node 18, unlike `"deflate-raw"`) and which checks the CRC and
+ * the length itself; stored entries (method 0) are checked against a CRC-32 table here. Every
+ * other method, and encryption, is refused by name. Entry names are decoded by `decodeEntryName()`
+ * (the one place bytes become text) and are matching keys only, never paths.
+ */
+import { decodeEntryName, throwIfAborted } from "./input.js";
+/** A zip that cannot be read, or an entry that cannot be inflated. */
+export class ZipError extends Error {
+    /**
+     * Create the error.
+     * @param kind - what went wrong
+     * @param message - a plain-ASCII message
+     */
+    constructor(kind, message) {
+        super(message);
+        this.name = "ZipError";
+        this.kind = kind;
+    }
+}
+/** A per-entry size under which the ratio limit does not apply (tiny entries compress well). */
+export const RATIO_FLOOR = 1024 * 1024;
+const EOCD_SIGNATURE = 0x06054b50;
+const ZIP64_LOCATOR_SIGNATURE = 0x07064b50;
+const ZIP64_EOCD_SIGNATURE = 0x06064b50;
+const CENTRAL_SIGNATURE = 0x02014b50;
+const LOCAL_SIGNATURE = 0x04034b50;
+const EOCD_SIZE = 22;
+const MAX_COMMENT = 65535;
+const CENTRAL_SIZE = 46;
+const LOCAL_SIZE = 30;
+const ZIP64_EOCD_SIZE = 56;
+const ZIP64_LOCATOR_SIZE = 20;
+const U16_MAX = 0xffff;
+const U32_MAX = 0xffffffff;
+/** Bytes between two cancellation checks while a stored entry's CRC is computed. */
+const CRC_SLICE = 1024 * 1024;
+/** The compression methods other tools write, by number, for the refusal message. */
+const METHOD_NAMES = {
+    1: "shrink",
+    6: "implode",
+    9: "deflate64",
+    12: "bzip2",
+    14: "LZMA",
+    93: "zstd",
+    95: "xz",
+    96: "JPEG",
+    97: "WavPack",
+    98: "PPMd",
+    99: "AES encryption",
+};
+/**
+ * Whether bytes start with a local file header signature (`PK\x03\x04`).
+ * @param bytes - the bytes
+ * @returns true for the start of a zip
+ */
+export function startsLikeZip(bytes) {
+    return bytes.byteLength >= 4 && bytes[0] === 0x50 && bytes[1] === 0x4b && bytes[2] === 3 && bytes[3] === 4;
+}
+/**
+ * Read the central directory.
+ * @param bytes - the whole archive
+ * @returns the entries in directory order; ZipError "not-zip" when there is no end record and the
+ * bytes do not start like a zip, "corrupt" for an end record or directory that does not fit,
+ * "unsupported" for a split archive
+ */
+export function readZipDirectory(bytes) {
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const eocd = findEndRecord(bytes, view);
+    if (eocd < 0) {
+        throw startsLikeZip(bytes)
+            ? new ZipError("corrupt", "the archive has no end of central directory record (truncated?)")
+            : new ZipError("not-zip", "the input is not a zip archive");
+    }
+    let disk = view.getUint16(eocd + 4, true);
+    let directoryDisk = view.getUint16(eocd + 6, true);
+    let count = view.getUint16(eocd + 10, true);
+    let directorySize = view.getUint32(eocd + 12, true);
+    let directoryOffset = view.getUint32(eocd + 16, true);
+    let directoryEnd = eocd;
+    const locator = eocd - ZIP64_LOCATOR_SIZE;
+    if (locator >= 0 && view.getUint32(locator, true) === ZIP64_LOCATOR_SIGNATURE) {
+        const record = zip64EndRecord(view, locator);
+        disk = view.getUint32(record + 16, true);
+        directoryDisk = view.getUint32(record + 20, true);
+        count = readU64(view, record + 32);
+        directorySize = readU64(view, record + 40);
+        directoryOffset = readU64(view, record + 48);
+        directoryEnd = record;
+    }
+    else if (count === U16_MAX || directorySize === U32_MAX || directoryOffset === U32_MAX) {
+        throw new ZipError("corrupt", "the end record needs a zip64 record the archive does not have");
+    }
+    if (disk !== 0 || directoryDisk !== 0) {
+        throw new ZipError("unsupported", "a split (multi-disk) archive cannot be read");
+    }
+    const start = directoryEnd - directorySize;
+    if (start < 0 || directoryOffset > bytes.byteLength) {
+        throw new ZipError("corrupt", "the central directory lies outside the archive");
+    }
+    // data prepended to the archive moves every offset by the same amount
+    const shift = start - directoryOffset;
+    if (shift < 0) {
+        throw new ZipError("corrupt", "the central directory offset does not match its position");
+    }
+    const entries = [];
+    let at = start;
+    for (let i = 0; i < count; i++) {
+        if (at + CENTRAL_SIZE > directoryEnd || view.getUint32(at, true) !== CENTRAL_SIGNATURE) {
+            throw new ZipError("corrupt", `central directory entry ${i + 1} of ${count} is damaged`);
+        }
+        const nameLength = view.getUint16(at + 28, true);
+        const extraLength = view.getUint16(at + 30, true);
+        const commentLength = view.getUint16(at + 32, true);
+        const next = at + CENTRAL_SIZE + nameLength + extraLength + commentLength;
+        if (next > directoryEnd) {
+            throw new ZipError("corrupt", `central directory entry ${i + 1} runs past the directory`);
+        }
+        const name = decodeEntryName(bytes.subarray(at + CENTRAL_SIZE, at + CENTRAL_SIZE + nameLength));
+        let compressedSize = view.getUint32(at + 20, true);
+        let size = view.getUint32(at + 24, true);
+        let localOffset = view.getUint32(at + 42, true);
+        if (compressedSize === U32_MAX || size === U32_MAX || localOffset === U32_MAX) {
+            ({ compressedSize, size, localOffset } = zip64Extra(view, at + CENTRAL_SIZE + nameLength, extraLength, {
+                compressedSize,
+                size,
+                localOffset,
+            }));
+        }
+        entries.push(Object.freeze({
+            name,
+            method: view.getUint16(at + 10, true),
+            flags: view.getUint16(at + 8, true),
+            crc32: view.getUint32(at + 16, true),
+            compressedSize,
+            size,
+            localOffset: localOffset + shift,
+            directory: name.endsWith("/"),
+        }));
+        at = next;
+    }
+    return entries;
+}
+/**
+ * The position of the end of central directory record: the last signature whose comment length
+ * fits the archive, else the last signature at all (an archive with bytes after its comment).
+ * @param bytes - the archive
+ * @param view - a view of it
+ * @returns the offset, or -1
+ */
+function findEndRecord(bytes, view) {
+    const lowest = Math.max(0, bytes.byteLength - EOCD_SIZE - MAX_COMMENT);
+    let fallback = -1;
+    for (let at = bytes.byteLength - EOCD_SIZE; at >= lowest; at--) {
+        if (view.getUint32(at, true) !== EOCD_SIGNATURE) {
+            continue;
+        }
+        if (at + EOCD_SIZE + view.getUint16(at + 20, true) === bytes.byteLength) {
+            return at;
+        }
+        if (fallback < 0) {
+            fallback = at;
+        }
+    }
+    return fallback;
+}
+/**
+ * The zip64 end of central directory record a locator points at (or, when the archive has bytes
+ * prepended, the one right before the locator).
+ * @param view - the archive
+ * @param locator - the locator's offset
+ * @returns the record's offset
+ */
+function zip64EndRecord(view, locator) {
+    const stated = readU64(view, locator + 8);
+    for (const at of [stated, locator - ZIP64_EOCD_SIZE]) {
+        if (at >= 0 && at + ZIP64_EOCD_SIZE <= locator && view.getUint32(at, true) === ZIP64_EOCD_SIGNATURE) {
+            return at;
+        }
+    }
+    throw new ZipError("corrupt", "the zip64 end record the locator names is missing");
+}
+/**
+ * The zip64 extended information extra field (header id 0x0001) of a central entry: the 64-bit
+ * values of the fields whose 32-bit slot is 0xFFFFFFFF, in the order APPNOTE 4.5.3 gives.
+ * @param view - the archive
+ * @param at - the start of the extra field
+ * @param length - its length
+ * @param fields - the 32-bit values
+ * @param fields.compressedSize - the compressed size slot
+ * @param fields.size - the uncompressed size slot
+ * @param fields.localOffset - the local header offset slot
+ * @returns the resolved values
+ */
+function zip64Extra(view, at, length, fields) {
+    const out = { ...fields };
+    for (let p = at; p + 4 <= at + length;) {
+        const id = view.getUint16(p, true);
+        const dataLength = view.getUint16(p + 2, true);
+        if (id === 1) {
+            let q = p + 4;
+            const end = q + dataLength;
+            for (const key of ["size", "compressedSize", "localOffset"]) {
+                if (fields[key] === U32_MAX) {
+                    if (q + 8 > end) {
+                        throw new ZipError("corrupt", "a zip64 extra field is too short");
+                    }
+                    out[key] = readU64(view, q);
+                    q += 8;
+                }
+            }
+            return out;
+        }
+        p += 4 + dataLength;
+    }
+    throw new ZipError("corrupt", "an entry needs a zip64 extra field it does not have");
+}
+/**
+ * An unsigned 64-bit little-endian integer as a number (exact up to 2^53).
+ * @param view - the bytes
+ * @param at - the offset
+ * @returns the value; ZipError "unsupported" beyond 2^53
+ */
+function readU64(view, at) {
+    const high = view.getUint32(at + 4, true);
+    if (high >= 0x200000) {
+        throw new ZipError("unsupported", "a zip64 size or offset beyond 2^53 cannot be read");
+    }
+    return high * 0x100000000 + view.getUint32(at, true);
+}
+/**
+ * Read one entry's data: stored entries are sliced and CRC-checked, deflated ones inflated.
+ * @param bytes - the whole archive
+ * @param entry - the entry
+ * @param options - cancellation, progress and the size limits
+ * @returns the uncompressed bytes; ZipError for a damaged, encrypted, unsupported or oversized entry
+ */
+export async function readZipEntry(bytes, entry, options) {
+    if ((entry.flags & 1) !== 0 || entry.method === 99) {
+        throw new ZipError("unsupported", `${entry.name}: the entry is encrypted`);
+    }
+    if (entry.method !== 0 && entry.method !== 8) {
+        const name = METHOD_NAMES[entry.method] ?? `method ${entry.method}`;
+        throw new ZipError("unsupported", `${entry.name}: compression ${name} is not supported (only stored and deflate)`);
+    }
+    if (entry.size > options.maxBytes) {
+        throw new ZipError("too-large", `${entry.name}: ${entry.size} uncompressed bytes exceed the limit of ${options.maxBytes}`);
+    }
+    if (entry.size > RATIO_FLOOR && entry.size > options.maxRatio * Math.max(entry.compressedSize, 1)) {
+        throw new ZipError("too-large", `${entry.name}: ${entry.size} bytes from ${entry.compressedSize} is a compression ratio above ${options.maxRatio}:1`);
+    }
+    const data = entryData(bytes, entry);
+    if (entry.method === 0) {
+        if (data.byteLength !== entry.size) {
+            throw new ZipError("corrupt", `${entry.name}: a stored entry's sizes disagree`);
+        }
+        let crc = 0xffffffff;
+        for (let at = 0; at < data.byteLength; at += CRC_SLICE) {
+            throwIfAborted(options.signal);
+            crc = crcUpdate(crc, data.subarray(at, Math.min(at + CRC_SLICE, data.byteLength)));
+            options.onBytes?.(Math.min(at + CRC_SLICE, data.byteLength));
+        }
+        if ((crc ^ 0xffffffff) >>> 0 !== entry.crc32) {
+            throw new ZipError("corrupt", `${entry.name}: the data does not match its CRC-32`);
+        }
+        return data;
+    }
+    return inflate(data, entry, options);
+}
+/**
+ * The compressed bytes of an entry, located through its local header (whose name and extra
+ * lengths can differ from the central directory's).
+ * @param bytes - the archive
+ * @param entry - the entry
+ * @returns exactly compressedSize bytes
+ */
+function entryData(bytes, entry) {
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const at = entry.localOffset;
+    if (at + LOCAL_SIZE > bytes.byteLength || view.getUint32(at, true) !== LOCAL_SIGNATURE) {
+        throw new ZipError("corrupt", `${entry.name}: the local header is missing`);
+    }
+    const start = at + LOCAL_SIZE + view.getUint16(at + 26, true) + view.getUint16(at + 28, true);
+    const end = start + entry.compressedSize;
+    if (end > bytes.byteLength) {
+        throw new ZipError("corrupt", `${entry.name}: the entry's data runs past the end of the archive (truncated?)`);
+    }
+    return bytes.subarray(start, end);
+}
+/**
+ * Inflate a deflate stream through `DecompressionStream("gzip")`, wrapped in a gzip member that
+ * carries the directory's CRC-32 and size, so the platform checks both.
+ * @param data - the raw deflate bytes
+ * @param entry - the entry
+ * @param options - cancellation, progress and limits
+ * @returns the bytes
+ */
+async function inflate(data, entry, options) {
+    if (typeof DecompressionStream !== "function") {
+        throw new ZipError("unsupported", "this runtime has no DecompressionStream, so deflated entries cannot be read");
+    }
+    const member = new Uint8Array(10 + data.byteLength + 8);
+    member.set([0x1f, 0x8b, 8, 0, 0, 0, 0, 0, 0, 0xff]);
+    member.set(data, 10);
+    const trailer = new DataView(member.buffer, 10 + data.byteLength, 8);
+    trailer.setUint32(0, entry.crc32, true);
+    trailer.setUint32(4, entry.size % 0x100000000, true);
+    const source = new ReadableStream({
+        start(controller) {
+            controller.enqueue(member);
+            controller.close();
+        },
+    });
+    const reader = source.pipeThrough(new DecompressionStream("gzip")).getReader();
+    const parts = [];
+    let total = 0;
+    try {
+        for (;;) {
+            throwIfAborted(options.signal);
+            let chunk;
+            try {
+                chunk = await reader.read();
+            }
+            catch {
+                throw new ZipError("corrupt", `${entry.name}: the deflate data is damaged or does not match its CRC-32 and size`);
+            }
+            if (chunk.done) {
+                break;
+            }
+            total += chunk.value.byteLength;
+            if (total > entry.size) {
+                throw new ZipError("corrupt", `${entry.name}: the data is longer than its directory size`);
+            }
+            parts.push(chunk.value);
+            options.onBytes?.(total);
+        }
+    }
+    finally {
+        await reader.cancel().catch(() => undefined);
+    }
+    if (total !== entry.size) {
+        throw new ZipError("corrupt", `${entry.name}: the data is shorter than its directory size`);
+    }
+    if (parts.length === 1) {
+        return parts[0];
+    }
+    const out = new Uint8Array(total);
+    let at = 0;
+    for (const part of parts) {
+        out.set(part, at);
+        at += part.byteLength;
+    }
+    return out;
+}
+/** The CRC-32 table (polynomial 0xEDB88320). */
+const CRC_TABLE = (() => {
+    const table = new Uint32Array(256);
+    for (let n = 0; n < 256; n++) {
+        let c = n;
+        for (let k = 0; k < 8; k++) {
+            c = (c & 1) === 1 ? 0xedb88320 ^ (c >>> 1) : c >>> 1;
+        }
+        table[n] = c >>> 0;
+    }
+    return table;
+})();
+/**
+ * Continue a CRC-32 over more bytes.
+ * @param crc - the running value (start with 0xFFFFFFFF)
+ * @param bytes - the bytes
+ * @returns the running value (XOR with 0xFFFFFFFF to finish)
+ */
+function crcUpdate(crc, bytes) {
+    let c = crc;
+    for (const byte of bytes) {
+        c = CRC_TABLE[(c ^ byte) & 0xff] ^ (c >>> 8);
+    }
+    return c >>> 0;
+}
+/**
+ * The CRC-32 of bytes.
+ * @param bytes - the bytes
+ * @returns the checksum
+ */
+export function crc32(bytes) {
+    return (crcUpdate(0xffffffff, bytes) ^ 0xffffffff) >>> 0;
+}
+//# sourceMappingURL=zip.js.map

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

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

package/dist/src/formats/cys/constants.d.ts

@@ -0,0 +1,68 @@
+/**
+ * What the Cytoscape session importer's modules share: the format facts, the column and metadata
+ * names it adds, and its issue code table (design `design/graph-io/cytoscape-and-obo/design.md`
+ * sections 1.4 and 3).
+ */
+/** The format name. */
+export declare const FORMAT = "cys";
+/** File extensions. */
+export declare const EXTENSIONS: readonly string[];
+/** MIME types: Cytoscape declares none, so the generic zip type. */
+export declare const MIME_TYPES: readonly string[];
+/** The `meta.extra` key of the session facts. */
+export declare const META_KEY = "cytoscape";
+/** The origin namespace of the columns the session importer adds (selection, hidden state). */
+export declare const CYTOSCAPE_NAMESPACE = "cytoscape";
+/** The 2.x selected state (bool node and edge column). */
+export declare const SELECTED_COLUMN = "cytoscape.selected";
+/** The 2.x hidden state (bool node and edge column). */
+export declare const HIDDEN_COLUMN = "cytoscape.hidden";
+/** The prefix of the node columns of a second and further view's positions (`position@2`). */
+export declare const VIEW_POSITION_PREFIX = "position@";
+/** The default total of uncompressed bytes one import may inflate (2 GiB). */
+export declare const DEFAULT_MAX_UNCOMPRESSED: number;
+/** The largest uncompressed-to-compressed ratio an entry may have (real sessions reach 30:1). */
+export declare const MAX_RATIO = 1000;
+/**
+ * Issue codes of the Cytoscape session importer: its own, the shared ones it records and the
+ * XGMML codes it relays from the files inside (with the entry name in the message).
+ */
+export declare const CYS_ISSUE: Readonly<{
+    /** The input is not a zip archive (or is text). */
+    NOT_ZIP: "E_CYS_NOT_ZIP";
+    /** The archive is damaged: no end record, offsets outside the file, a bad CRC, truncated data. */
+    CORRUPT: "E_CYS_CORRUPT";
+    /** A zip without a session marker (`<x.y.z>.version` or `cysession.xml`). */
+    NOT_SESSION: "E_CYS_NOT_SESSION";
+    /** A zip feature the reader does not support: encryption, a compression method, split archives. */
+    UNSUPPORTED: "E_CYS_UNSUPPORTED";
+    /** A session version graph-io cannot read: a major above 3, or the 2011 3.0 pre-release layout. */
+    VERSION: "E_CYS_VERSION";
+    /** A table or a virtual column that cannot be read at all; it is skipped. */
+    TABLE: "E_CYS_TABLE";
+    /** Table rows with too few or too many cells, a repeated key, or a key matching no element. */
+    TABLE_ROW: "W_CYS_TABLE_ROW";
+    /** A collapsed group's members are not in the network; they are recorded in meta.extra. */
+    COLLAPSED_GROUP: "W_CYS_COLLAPSED_GROUP";
+    /** Entries the importer does not read (apps, global tables, properties, images, thumbnails). */
+    ENTRY_SKIPPED: "W_CYS_ENTRY_SKIPPED";
+    /** Two entries with one name; the first is read. */
+    DUPLICATE_ENTRY: "W_CYS_DUPLICATE_ENTRY";
+    /** The archive inflates beyond maxUncompressedBytes, or an entry beyond the ratio limit. */
+    TOO_LARGE: "E_TOO_LARGE";
+    /** The session's styles are not applied (issue #706). */
+    STYLES_NOT_IMPORTED: "W_STYLES_NOT_IMPORTED";
+    /** A view, table or network the session names but does not hold. */
+    DANGLING_REFERENCE: "W_DANGLING_REFERENCE";
+    /** The input is empty. */
+    EMPTY_INPUT: "E_EMPTY_INPUT";
+    /** The session holds no network. */
+    NO_GRAPH: "E_NO_GRAPH";
+    /** The session holds several networks; one was read. */
+    MULTIPLE_GRAPHS: "W_MULTIPLE_GRAPHS";
+    /** graphIndex / graphName names no network (fatal). */
+    GRAPH_NOT_FOUND: "E_GRAPH_NOT_FOUND";
+    /** graphName names several networks (fatal). */
+    AMBIGUOUS_GRAPH_NAME: "E_AMBIGUOUS_GRAPH_NAME";
+}>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/formats/cys/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/formats/cys/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,uBAAuB;AACvB,eAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,uBAAuB;AACvB,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAA4B,CAAC;AAErE,oEAAoE;AACpE,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAuC,CAAC;AAEhF,iDAAiD;AACjD,eAAO,MAAM,QAAQ,cAAc,CAAC;AAEpC,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,cAAc,CAAC;AAE/C,0DAA0D;AAC1D,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,wDAAwD;AACxD,eAAO,MAAM,aAAa,qBAAqB,CAAC;AAEhD,8FAA8F;AAC9F,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,QAAyB,CAAC;AAE/D,iGAAiG;AACjG,eAAO,MAAM,SAAS,OAAO,CAAC;AAU9B;;;GAGG;AACH,eAAO,MAAM,SAAS;IAElB,mDAAmD;;IAEnD,kGAAkG;;IAElG,6EAA6E;;IAE7E,mGAAmG;;IAEnG,mGAAmG;;IAEnG,6EAA6E;;IAE7E,+FAA+F;;IAE/F,2FAA2F;;IAE3F,gGAAgG;;IAEhG,oDAAoD;;IAEpD,4FAA4F;;IAE5F,yDAAyD;;IAEzD,oEAAoE;;IAEpE,0BAA0B;;IAE1B,oCAAoC;;IAEpC,wDAAwD;;IAExD,uDAAuD;;IAEvD,gDAAgD;;EAElD,CAAC"}

package/dist/src/formats/cys/constants.js

@@ -0,0 +1,76 @@
+/**
+ * What the Cytoscape session importer's modules share: the format facts, the column and metadata
+ * names it adds, and its issue code table (design `design/graph-io/cytoscape-and-obo/design.md`
+ * sections 1.4 and 3).
+ */
+import { AMBIGUOUS_GRAPH_NAME_CODE, DANGLING_REFERENCE_CODE, EMPTY_INPUT_CODE, GRAPH_NOT_FOUND_CODE, MULTIPLE_GRAPHS_CODE, NO_GRAPH_CODE, STYLES_NOT_IMPORTED_CODE, TOO_LARGE_CODE, } from "../../common/codes.js";
+import { XGMML_ISSUE } from "../xgmml/constants.js";
+/** The format name. */
+export const FORMAT = "cys";
+/** File extensions. */
+export const EXTENSIONS = Object.freeze([".cys"]);
+/** MIME types: Cytoscape declares none, so the generic zip type. */
+export const MIME_TYPES = Object.freeze(["application/zip"]);
+/** The `meta.extra` key of the session facts. */
+export const META_KEY = "cytoscape";
+/** The origin namespace of the columns the session importer adds (selection, hidden state). */
+export const CYTOSCAPE_NAMESPACE = "cytoscape";
+/** The 2.x selected state (bool node and edge column). */
+export const SELECTED_COLUMN = "cytoscape.selected";
+/** The 2.x hidden state (bool node and edge column). */
+export const HIDDEN_COLUMN = "cytoscape.hidden";
+/** The prefix of the node columns of a second and further view's positions (`position@2`). */
+export const VIEW_POSITION_PREFIX = "position@";
+/** The default total of uncompressed bytes one import may inflate (2 GiB). */
+export const DEFAULT_MAX_UNCOMPRESSED = 2 * 1024 * 1024 * 1024;
+/** The largest uncompressed-to-compressed ratio an entry may have (real sessions reach 30:1). */
+export const MAX_RATIO = 1000;
+/**
+ * The XGMML codes the session importer relays from the network and view files inside, keyed as
+ * every table is (the code without its `E_` / `W_` prefix).
+ */
+const RELAYED = Object.fromEntries(Object.values(XGMML_ISSUE).map((code) => [code.replace(/^[EW]_/, ""), code]));
+/**
+ * Issue codes of the Cytoscape session importer: its own, the shared ones it records and the
+ * XGMML codes it relays from the files inside (with the entry name in the message).
+ */
+export const CYS_ISSUE = Object.freeze({
+    ...RELAYED,
+    /** The input is not a zip archive (or is text). */
+    NOT_ZIP: "E_CYS_NOT_ZIP",
+    /** The archive is damaged: no end record, offsets outside the file, a bad CRC, truncated data. */
+    CORRUPT: "E_CYS_CORRUPT",
+    /** A zip without a session marker (`<x.y.z>.version` or `cysession.xml`). */
+    NOT_SESSION: "E_CYS_NOT_SESSION",
+    /** A zip feature the reader does not support: encryption, a compression method, split archives. */
+    UNSUPPORTED: "E_CYS_UNSUPPORTED",
+    /** A session version graph-io cannot read: a major above 3, or the 2011 3.0 pre-release layout. */
+    VERSION: "E_CYS_VERSION",
+    /** A table or a virtual column that cannot be read at all; it is skipped. */
+    TABLE: "E_CYS_TABLE",
+    /** Table rows with too few or too many cells, a repeated key, or a key matching no element. */
+    TABLE_ROW: "W_CYS_TABLE_ROW",
+    /** A collapsed group's members are not in the network; they are recorded in meta.extra. */
+    COLLAPSED_GROUP: "W_CYS_COLLAPSED_GROUP",
+    /** Entries the importer does not read (apps, global tables, properties, images, thumbnails). */
+    ENTRY_SKIPPED: "W_CYS_ENTRY_SKIPPED",
+    /** Two entries with one name; the first is read. */
+    DUPLICATE_ENTRY: "W_CYS_DUPLICATE_ENTRY",
+    /** The archive inflates beyond maxUncompressedBytes, or an entry beyond the ratio limit. */
+    TOO_LARGE: TOO_LARGE_CODE,
+    /** The session's styles are not applied (issue #706). */
+    STYLES_NOT_IMPORTED: STYLES_NOT_IMPORTED_CODE,
+    /** A view, table or network the session names but does not hold. */
+    DANGLING_REFERENCE: DANGLING_REFERENCE_CODE,
+    /** The input is empty. */
+    EMPTY_INPUT: EMPTY_INPUT_CODE,
+    /** The session holds no network. */
+    NO_GRAPH: NO_GRAPH_CODE,
+    /** The session holds several networks; one was read. */
+    MULTIPLE_GRAPHS: MULTIPLE_GRAPHS_CODE,
+    /** graphIndex / graphName names no network (fatal). */
+    GRAPH_NOT_FOUND: GRAPH_NOT_FOUND_CODE,
+    /** graphName names several networks (fatal). */
+    AMBIGUOUS_GRAPH_NAME: AMBIGUOUS_GRAPH_NAME_CODE,
+});
+//# sourceMappingURL=constants.js.map

package/dist/src/formats/cys/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/formats/cys/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACb,wBAAwB,EACxB,cAAc,GACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,uBAAuB;AACvB,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC;AAE5B,uBAAuB;AACvB,MAAM,CAAC,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAErE,oEAAoE;AACpE,MAAM,CAAC,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAEhF,iDAAiD;AACjD,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEpC,+FAA+F;AAC/F,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAE/C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEpD,wDAAwD;AACxD,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEhD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE/D,iGAAiG;AACjG,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC;AAE9B;;;GAGG;AACH,MAAM,OAAO,GAAqC,MAAM,CAAC,WAAW,CAChE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,CAC/E,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,GAAG,OAAO;IACV,mDAAmD;IACnD,OAAO,EAAE,eAAe;IACxB,kGAAkG;IAClG,OAAO,EAAE,eAAe;IACxB,6EAA6E;IAC7E,WAAW,EAAE,mBAAmB;IAChC,mGAAmG;IACnG,WAAW,EAAE,mBAAmB;IAChC,mGAAmG;IACnG,OAAO,EAAE,eAAe;IACxB,6EAA6E;IAC7E,KAAK,EAAE,aAAa;IACpB,+FAA+F;IAC/F,SAAS,EAAE,iBAAiB;IAC5B,2FAA2F;IAC3F,eAAe,EAAE,uBAAuB;IACxC,gGAAgG;IAChG,aAAa,EAAE,qBAAqB;IACpC,oDAAoD;IACpD,eAAe,EAAE,uBAAuB;IACxC,4FAA4F;IAC5F,SAAS,EAAE,cAAc;IACzB,yDAAyD;IACzD,mBAAmB,EAAE,wBAAwB;IAC7C,oEAAoE;IACpE,kBAAkB,EAAE,uBAAuB;IAC3C,0BAA0B;IAC1B,WAAW,EAAE,gBAAgB;IAC7B,oCAAoC;IACpC,QAAQ,EAAE,aAAa;IACvB,wDAAwD;IACxD,eAAe,EAAE,oBAAoB;IACrC,uDAAuD;IACvD,eAAe,EAAE,oBAAoB;IACrC,gDAAgD;IAChD,oBAAoB,EAAE,yBAAyB;CAClD,CAAC,CAAC"}

package/dist/src/formats/cys/importer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The Cytoscape session importer (design `design/graph-io/cytoscape-and-obo/design.md` sections
+ * 1.4 and 3; `research-session-and-style.md`). A session is a zip of every network of a Cytoscape
+ * desktop; the unit of import is the registered subnetwork (3.x) or the network (2.x), one
+ * snapshot each: `import()` reads the one `graphIndex` / `graphName` picks (the first by default),
+ * `importAll()` every one, and `listGraphs()` lists them from the network files alone.
+ *
+ * 3.x: the network file gives the topology (shared nodes through `xlink:href`, per-edge direction,
+ * groups, nested-network pointers); the subnetwork's CyCSV tables give its columns (LOCAL_ATTRS as
+ * they are, the SHARED_ATTRS columns `cytables.xml` joins in, HIDDEN and app tables as hidden
+ * columns under their namespace); its first view gives positions (y flipped) and the `graphics`
+ * column, further views `position@<n>` columns. 2.x: one full XGMML file per network, with
+ * selection and hidden state from `cysession.xml`. Everything is resolved by the XGMML emitter, so
+ * both readers share every column rule. Styles are not read (issue #706): W_STYLES_NOT_IMPORTED.
+ */
+import { type GraphChoiceOptions, type GraphImporter } from "../../types.js";
+/** The format-specific options of the session importer. */
+export interface CysImportOptions extends GraphChoiceOptions {
+    /** Where Cytoscape's z (a stacking order) goes: the `z` column (default) or the position. */
+    zAs?: "column" | "position" | undefined;
+    /**
+     * The most bytes one import may inflate, in total (default 2 GiB); an entry beyond it, or one
+     * whose compression ratio is above 1000:1, is E_TOO_LARGE.
+     */
+    maxUncompressedBytes?: number | undefined;
+}
+/**
+ * Confidence that a head of bytes is a Cytoscape session: 0.95 for a zip whose head names the
+ * session folder, its version marker or cysession.xml; 0 for any other zip, so an `.xlsx`, a
+ * `.docx` or a zipped GraphML ranks as no format rather than as a broken session. The zip may
+ * start after a short stub (a self-extracting archive) within the head.
+ * @param head - the first bytes
+ * @returns the confidence
+ */
+export declare function sniffCys(head: Uint8Array): number;
+/** The Cytoscape session importer. */
+export declare const cysImporter: GraphImporter<CysImportOptions>;
+//# sourceMappingURL=importer.d.ts.map

package/dist/src/formats/cys/importer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importer.d.ts","sourceRoot":"","sources":["../../../../src/formats/cys/importer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAKrB,MAAM,gBAAgB,CAAC;AA6CxB,2DAA2D;AAC3D,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IACxD,6FAA6F;IAC7F,GAAG,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACxC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7C;AAo9BD;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAOjD;AAED,sCAAsC;AACtC,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAQtD,CAAC"}