@graphty/cytoscape-extensions 0.0.28 → 0.0.29

package/dist/graph-data.js

@@ -0,0 +1,147 @@
+/**
+ * The core methods that put graphs into Cytoscape and take them out: graphtyGenerate, graphtyDataset,
+ * graphtyImport and graphtyExport. Each loads its implementation (./samples.js or ./io.js, and with them the
+ * graph-samples or graph-io package) on its first call, so registering them costs a page nothing.
+ */
+import { coreDestroyedError } from "./gpu.js";
+import { loadPart } from "./lazy.js";
+/**
+ * Rejected by graphtyGenerate, graphtyDataset and graphtyImport when a node id of the new graph is already in the
+ * core; nothing is added. `name` is "IdTakenError", `code` is "E_ID_TAKEN" and `id` is the first clashing id.
+ */
+export class IdTakenError extends Error {
+    /**
+     * Creates the error.
+     * @param id - the clashing id
+     */
+    constructor(id) {
+        super(`graphty: the core already has an element with id "${id}", so the new graph would merge into it; ` +
+            "remove the existing elements (cy.elements().remove()) or add the graph to an empty core");
+        /** Always "E_ID_TAKEN". */
+        this.code = "E_ID_TAKEN";
+        this.name = "IdTakenError";
+        this.id = id;
+    }
+}
+/**
+ * Adds element definitions to a core. An edge whose id the core already holds loses it and gets one from
+ * Cytoscape, so a second import into the same core does not fail on edge ids the file chose. A node id the core
+ * already holds is refused: Cytoscape would skip that node and attach the new edges to the old one, merging the
+ * two graphs.
+ * @param cy - the core
+ * @param elements - the definitions; edge data may be changed
+ * @returns the added elements
+ * @throws IdTakenError naming the first node id the core already holds; nothing is added
+ * @throws Error coded E_CORE_DESTROYED when the core was destroyed (before the call or while it loaded); nothing
+ * is added
+ */
+function addTo(cy, elements) {
+    if (cy.destroyed()) {
+        throw coreDestroyedError();
+    }
+    for (const el of elements) {
+        if (el.group === "nodes" && el.data.id !== undefined && cy.getElementById(el.data.id).nonempty()) {
+            throw new IdTakenError(el.data.id);
+        }
+    }
+    for (const el of elements) {
+        if (el.group === "edges" && el.data.id !== undefined && cy.getElementById(el.data.id).nonempty()) {
+            delete el.data.id;
+        }
+    }
+    return cy.add(elements);
+}
+/**
+ * An import id no element of the core holds yet.
+ * @param cy - the core
+ * @returns the id
+ */
+function freeImportId(cy) {
+    const taken = new Set(cy.elements("[graphty_import]").map((e) => String(e.data("graphty_import"))));
+    let k = taken.size + 1;
+    while (taken.has(String(k))) {
+        k++;
+    }
+    return String(k);
+}
+/**
+ * Sets each added element's style bypass. Cytoscape skips a definition whose id an earlier one took, so the added
+ * collection is walked beside the definitions and a definition gets its bypass only when it is the next element.
+ * @param added - what cy.add returned, in definition order
+ * @param defs - the definitions, whose `data.id` cy.add filled in
+ * @param bypass - one bypass or null per definition
+ */
+function applyBypass(added, defs, bypass) {
+    let j = 0;
+    defs.forEach((def, i) => {
+        const ele = added[j];
+        if (ele?.id() !== def.data.id) {
+            return;
+        }
+        j++;
+        const b = bypass[i];
+        if (b !== null && b !== undefined) {
+            ele.style(b);
+        }
+    });
+}
+/**
+ * Registers graphtyGenerate, graphtyDataset, graphtyImport and graphtyExport.
+ * @param cytoscape - the cytoscape function
+ */
+export function registerGraphData(cytoscape) {
+    cytoscape("core", "graphtyGenerate", async function (name, options) {
+        const { generateElements } = await loadPart(import("./samples.js"), "graphtyGenerate");
+        const r = generateElements(name, options);
+        return { elements: addTo(this, r.elements), directed: r.directed };
+    });
+    cytoscape("core", "graphtyDataset", async function (name, options) {
+        const { datasetElements } = await loadPart(import("./samples.js"), "graphtyDataset");
+        const r = await datasetElements(name, options);
+        options?.signal?.throwIfAborted();
+        return { elements: addTo(this, r.elements), directed: r.directed };
+    });
+    cytoscape("core", "graphtyImport", async function (input, format, options) {
+        const { importElements } = await loadPart(import("./io.js"), "graphtyImport");
+        const styled = options?.styles !== undefined && options.styles !== false;
+        const r = await importElements(input, format, {
+            ...options,
+            ...(styled && options.importId === undefined ? { importId: freeImportId(this) } : {}),
+        });
+        const apply = options?.applyStyles === true && r.stylesheet !== undefined;
+        const elements = addTo(this, r.elements);
+        if (apply && r.bypass !== undefined) {
+            // Set after the add, not as the definition's `style`: Cytoscape 3.31 applies a creation-time
+            // bypass before the edge has its endpoints, and a `curve-style` there throws in parallelEdges().
+            applyBypass(elements, r.elements, r.bypass);
+        }
+        const style = this.style();
+        if (apply && r.stylesheet !== undefined && style !== undefined) {
+            // appended rule by rule: a round trip through style.json() turns the core's own function-valued
+            // properties into the string "fn", which Cytoscape then rejects
+            let s = style;
+            for (const rule of r.stylesheet) {
+                s = s.selector(rule.selector).style(rule.style);
+            }
+            s.update();
+        }
+        return {
+            elements,
+            directed: r.directed,
+            format: r.format,
+            report: r.report,
+            ...(r.stylesheet === undefined ? {} : { stylesheet: r.stylesheet }),
+        };
+    });
+    const exportFn = async (eles, format, options) => {
+        const { exportElements } = await loadPart(import("./io.js"), "graphtyExport");
+        return exportElements(eles, format, options);
+    };
+    cytoscape("core", "graphtyExport", function (format, options) {
+        return exportFn(this.elements(), format, options);
+    });
+    cytoscape("collection", "graphtyExport", function (format, options) {
+        return exportFn(this, format, options);
+    });
+}
+//# sourceMappingURL=graph-data.js.map

package/dist/graph-data.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The Cytoscape.js adapter (package "@graphty/cytoscape-extensions"): graphty layouts and algorithms as Cytoscape.js extensions.
+ *
+ * ```ts
+ * import cytoscape from "cytoscape";
+ * import graphtyCytoscape from "@graphty/cytoscape-extensions";
+ * cytoscape.use(graphtyCytoscape);
+ * cy.layout({ name: "graphty-forceatlas2" }).run();
+ * cy.elements().graphtyPageRank().rank("#a");
+ *
+ * // the ...Async methods and the simulations use WebGPU when the runtime has it; nothing else to import
+ * const r = await cy.elements().graphtyPageRankAsync();
+ * r.backend.ran; // "gpu" or "cpu", with r.backend.reason saying why
+ *
+ * // graphs in and out; each loads its parsers or generators on first use
+ * await cy.graphtyGenerate("barabasi-albert", { n: 500, m: 2, seed: 1 });
+ * await cy.graphtyImport(graphmlText, "graphml");
+ * const gexf = await cy.graphtyExport("gexf");
+ * ```
+ */
+export { ALGORITHM_NAMES, type AlgorithmOptions, ASYNC_ALGORITHM_NAMES, type CutResult, type ElementRef, type GraphtyAlgorithms, type NodePair, type Partition, type PathsResult, type PointPathResult, type PredictedLink, type ScoreResult, type SearchResult, } from "./algorithms.js";
+export { type Backend, configureWebGpu, GPU_SIZE_FLOOR, type GpuMode, type WebGpuOptions } from "./gpu.js";
+export { type AddedGraph, type GraphtyGraphData, IdTakenError, type ImportedGraph } from "./graph-data.js";
+export type { CytoscapeStylesheetRule, ExportFormat, ExportOptions, ImportFormat, ImportOptions, LossNote, } from "./io.js";
+export { type GraphtyLayoutName, type GraphtyLayoutOptions, type GraphtyLayoutOptionsByName, type GraphtyLayouts, LAYOUT_NAMES, } from "./layouts.js";
+export type { GeneratorName, GeneratorOptions } from "./samples.js";
+export { type CytoscapeSnapshot, type NodeSelection, type SnapshotOptions, toSnapshot, writeData } from "./snapshot.js";
+/**
+ * The Cytoscape extension: `cytoscape.use(graphtyCytoscape)` registers every layout in LAYOUT_NAMES as
+ * "graphty-<name>", every algorithm in ALGORITHM_NAMES as a collection and core method, and the core methods
+ * graphtyGenerate, graphtyDataset, graphtyImport and graphtyExport. A second `use()` with the same cytoscape does
+ * nothing (the script-tag build has already registered itself when a page calls `use()` again).
+ * @param cytoscape - the cytoscape function `use()` passes in
+ */
+export default function graphtyCytoscape(cytoscape: (type: string, name: string, registrant: unknown) => void): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,EACH,eAAe,EACf,KAAK,gBAAgB,EACrB,qBAAqB,EACrB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAC3G,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3G,YAAY,EACR,uBAAuB,EACvB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,QAAQ,GACX,MAAM,SAAS,CAAC;AACjB,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,YAAY,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAKxH;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CASnH"}

package/dist/index.js

@@ -0,0 +1,48 @@
+/**
+ * The Cytoscape.js adapter (package "@graphty/cytoscape-extensions"): graphty layouts and algorithms as Cytoscape.js extensions.
+ *
+ * ```ts
+ * import cytoscape from "cytoscape";
+ * import graphtyCytoscape from "@graphty/cytoscape-extensions";
+ * cytoscape.use(graphtyCytoscape);
+ * cy.layout({ name: "graphty-forceatlas2" }).run();
+ * cy.elements().graphtyPageRank().rank("#a");
+ *
+ * // the ...Async methods and the simulations use WebGPU when the runtime has it; nothing else to import
+ * const r = await cy.elements().graphtyPageRankAsync();
+ * r.backend.ran; // "gpu" or "cpu", with r.backend.reason saying why
+ *
+ * // graphs in and out; each loads its parsers or generators on first use
+ * await cy.graphtyGenerate("barabasi-albert", { n: 500, m: 2, seed: 1 });
+ * await cy.graphtyImport(graphmlText, "graphml");
+ * const gexf = await cy.graphtyExport("gexf");
+ * ```
+ */
+import { registerAlgorithms } from "./algorithms.js";
+import { registerGraphData } from "./graph-data.js";
+import { registerLayouts } from "./layouts.js";
+export { ALGORITHM_NAMES, ASYNC_ALGORITHM_NAMES, } from "./algorithms.js";
+export { configureWebGpu, GPU_SIZE_FLOOR } from "./gpu.js";
+export { IdTakenError } from "./graph-data.js";
+export { LAYOUT_NAMES, } from "./layouts.js";
+export { toSnapshot, writeData } from "./snapshot.js";
+/** Set on a cytoscape function once the extension is registered on it. */
+const REGISTERED = Symbol.for("@graphty/cytoscape-extensions");
+/**
+ * The Cytoscape extension: `cytoscape.use(graphtyCytoscape)` registers every layout in LAYOUT_NAMES as
+ * "graphty-<name>", every algorithm in ALGORITHM_NAMES as a collection and core method, and the core methods
+ * graphtyGenerate, graphtyDataset, graphtyImport and graphtyExport. A second `use()` with the same cytoscape does
+ * nothing (the script-tag build has already registered itself when a page calls `use()` again).
+ * @param cytoscape - the cytoscape function `use()` passes in
+ */
+export default function graphtyCytoscape(cytoscape) {
+    const marked = cytoscape;
+    if (marked[REGISTERED] === true) {
+        return;
+    }
+    marked[REGISTERED] = true;
+    registerLayouts(cytoscape);
+    registerAlgorithms(cytoscape);
+    registerGraphData(cytoscape);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EACH,eAAe,EAEf,qBAAqB,GAWxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAgB,eAAe,EAAE,cAAc,EAAoC,MAAM,UAAU,CAAC;AAC3G,OAAO,EAA0C,YAAY,EAAsB,MAAM,iBAAiB,CAAC;AAS3G,OAAO,EAKH,YAAY,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAoE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAExH,0EAA0E;AAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,SAAoE;IACzG,MAAM,MAAM,GAAG,SAA2D,CAAC;IAC3E,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,OAAO;IACX,CAAC;IACD,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC1B,eAAe,CAAC,SAAS,CAAC,CAAC;IAC3B,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9B,iBAAiB,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC"}

package/dist/io.d.ts

@@ -0,0 +1,111 @@
+/**
+ * `@graphty/cytoscape-extensions/io`: reading and writing Cytoscape graphs in the file formats of @graphty/graph-io.
+ * cy.graphtyImport() and cy.graphtyExport() load this module on their first call, so a page that never imports or
+ * exports a file never downloads the parsers.
+ */
+import { type CommonExportOptions, type ImportGraphOptions, type ImportInput, type ImportReport, type LossNote } from "@graphty/graph-io";
+import { type CytoscapeStylesheetRule } from "@graphty/graph-io/styles";
+import type { Collection, ElementDefinition } from "cytoscape";
+/** One thing graphtyExport's format cannot hold: `code`, `message`, the data field (`column`) and how many values. */
+export type { LossNote } from "@graphty/graph-io";
+/**
+ * The formats graphtyImport reads; "auto" sniffs the format from the content (and `filename` when given). "cys" is a
+ * Cytoscape desktop session file, which must be passed as bytes.
+ */
+export type ImportFormat = "auto" | "gexf" | "graphml" | "gml" | "dot" | "pajek" | "csv" | "json" | "neo4j" | "xgmml" | "cx2" | "cx" | "obo" | "cys";
+/** The formats graphtyExport writes. XGMML is the one Cytoscape desktop opens as a network file. */
+export type ExportFormat = "gexf" | "graphml" | "gml" | "dot" | "pajek" | "csv" | "json" | "neo4j" | "xgmml" | "cx2";
+/** One rule of a Cytoscape.js stylesheet: a selector and its properties. */
+export type { CytoscapeStylesheetRule } from "@graphty/graph-io/styles";
+/**
+ * Options of graphtyImport: graph-io's import options (`filename`, `graphIndex`, format-specific ones, ...).
+ * `styles: true` also reads the file's styles (its colors, sizes, shapes, ...) as a Cytoscape.js stylesheet,
+ * returned as `stylesheet`; a property the file leaves to the program that wrote it gets that program's default
+ * (`styles: { toolDefaults: false }` leaves them out).
+ */
+export type ImportOptions = Omit<ImportGraphOptions, "format"> & {
+    /**
+     * With `styles`, graphtyImport also appends the file's stylesheet to the core's own and gives each element the
+     * per-element overrides that make it exact. Default false: the stylesheet is only returned.
+     */
+    readonly applyStyles?: boolean | undefined;
+    /**
+     * With `styles`, the value of the `graphty_import` data field every imported element gets and every rule of the
+     * stylesheet tests, so a second import into the same core never restyles the first one's elements. Default: a
+     * new one for each import.
+     */
+    readonly importId?: string | undefined;
+};
+/**
+ * Options of graphtyExport: graph-io's export options for the format, plus whether to write a directed graph.
+ * `sanitizeIds` defaults to "mangle" here (graph-io's default is "error"): GML and CX2 take only integer ids, so
+ * when a node id is not a plain non-negative integer ("a", "-1", "007") the nodes are numbered and the original
+ * kept in an attribute graphtyImport restores. When every id is one ("0", "17"), the ids are written as they are,
+ * and "error" accepts them too.
+ * JSON is written as Cytoscape JSON (`dialect: "cytoscape"`, the shape `cy.json()` and `cy.add()` use), which keeps
+ * edge ids, compound parents and positions; pass `dialect: "node-link"` for the NetworkX shape.
+ */
+export interface ExportOptions extends CommonExportOptions {
+    /**
+     * Write the core's styles too: its stylesheet's rules, with what the core draws for each element as the truth
+     * (a function-valued property is written per element and reported as W_STYLE_LAYER_FLATTENED). Each format
+     * keeps as much of them as it can, so importing the file with `styles: true` draws the same; `onLoss` hears
+     * about the rest (W_STYLE_ codes). Default false: without it `onLoss` hears W_STYLES_NOT_EXPORTED when the core
+     * has a stylesheet of its own.
+     */
+    readonly styles?: boolean | undefined;
+    /** Format-specific options, passed to graph-io as they are. */
+    readonly [formatOption: string]: unknown;
+    /** Write the graph as directed. Default false. */
+    readonly directed?: boolean | undefined;
+    /**
+     * Called before writing with what the format cannot hold (positions in GraphML, lists and objects in DOT,
+     * ...), one note per column and kind of loss; not called when nothing is lost. Without it a loss is silent.
+     */
+    readonly onLoss?: ((notes: readonly LossNote[]) => void) | undefined;
+}
+/** A file read into Cytoscape element definitions. */
+export interface ImportedElements {
+    /** The nodes, then the edges. */
+    readonly elements: ElementDefinition[];
+    /** Whether the file's graph is directed: pass it as `directed` to the algorithms. */
+    readonly directed: boolean;
+    /** The format the input was read as. */
+    readonly format: string;
+    /** graph-io's report: counts, warnings, and what could not be represented. */
+    readonly report: ImportReport;
+    /**
+     * With `styles`, the file's styles as a Cytoscape.js stylesheet scoped to this import; append it to the core's
+     * rule by rule (`cy.style().selector(r.selector).style(r.style)` for each, then `cy.style().update()`). Absent
+     * without `styles`.
+     */
+    readonly stylesheet?: CytoscapeStylesheetRule[];
+    /**
+     * With `styles`, per element (in the order of `elements`) the style overrides that make it draw exactly as the
+     * file says where the stylesheet alone does not, or null; give them as each definition's `style`.
+     */
+    readonly bypass?: (Readonly<Record<string, string | number>> | null)[];
+}
+/**
+ * Reads a graph file into Cytoscape element definitions.
+ * Without `styles`, a GEXF `viz:color`, `viz:size`, `viz:shape` and `viz:thickness` also become data fields
+ * (`data.color` as four numbers from 0 to 1, `data.size`, `data.shape`, `data.thickness`); these fields are
+ * deprecated and are removed in the next major release: import with `styles: true`, whose stylesheet draws them.
+ * With `styles: true` they are left out of data.
+ * @param input - the file as text, bytes, a stream or chunks
+ * @param format - the format, or "auto" to sniff it
+ * @param options - graph-io's import options
+ * @returns the elements, the direction, the format and graph-io's report
+ * @throws ImportError (from graph-io) when the file cannot be read, or when it yields no node and reports an error
+ */
+export declare function importElements(input: ImportInput | ArrayBuffer, format?: ImportFormat, options?: ImportOptions): Promise<ImportedElements>;
+/**
+ * Writes a collection as a graph file: every data field, each node's position and compound parent, and each
+ * edge's id, as far as the format holds them (`onLoss` hears about the rest).
+ * @param eles - the nodes and the edges between them
+ * @param format - the format
+ * @param options - graph-io's export options for the format, plus `directed`
+ * @returns the file's text; rejects (a TypeError) when `eles` is not a collection
+ */
+export declare function exportElements(eles: Collection, format: ExportFormat, options?: ExportOptions): Promise<string>;
+//# sourceMappingURL=io.d.ts.map

package/dist/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../src/io.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAEH,KAAK,mBAAmB,EAIxB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAEhB,KAAK,YAAY,EACjB,KAAK,QAAQ,EAEhB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,KAAK,uBAAuB,EAM/B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,UAAU,EAAQ,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAIrE,sHAAsH;AACtH,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAClB,MAAM,GACN,MAAM,GACN,SAAS,GACT,KAAK,GACL,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,GACN,OAAO,GACP,OAAO,GACP,KAAK,GACL,IAAI,GACJ,KAAK,GACL,KAAK,CAAC;AAEZ,oGAAoG;AACpG,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAErH,4EAA4E;AAC5E,YAAY,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAAG;IAC7D;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAc,SAAQ,mBAAmB;IACtD;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,+DAA+D;IAC/D,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACxE;AAED,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IACvC,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAChD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;CAC1E;AAqBD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAChC,KAAK,EAAE,WAAW,GAAG,WAAW,EAChC,MAAM,GAAE,YAAqB,EAC7B,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAwE3B;AAyID;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,aAAkB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA8BjB"}

package/dist/io.js

@@ -0,0 +1,258 @@
+/**
+ * `@graphty/cytoscape-extensions/io`: reading and writing Cytoscape graphs in the file formats of @graphty/graph-io.
+ * cy.graphtyImport() and cy.graphtyExport() load this module on their first call, so a page that never imports or
+ * exports a file never downloads the parsers.
+ */
+import { checkExport, exportGraphToString, ImportError, importGraph, registry, } from "@graphty/graph-io";
+import { extractPositions } from "@graphty/graph-io/positions";
+import { readCytoscapeStyles, STYLE_ISSUE, toCytoscapeStylesheet, } from "@graphty/graph-io/styles";
+import { elementsToSnapshot, exportedEdges, flipY, snapshotToElements } from "./elements.js";
+/** How many imports have read styles: the default import ids. */
+let imports = 0;
+/**
+ * A style note as a report warning.
+ * @param n - the note
+ * @returns the issue
+ */
+function styleIssue(n) {
+    return {
+        category: "unsupported",
+        severity: "warning",
+        code: n.code,
+        message: n.message,
+        line: null,
+        element: n.params.property,
+    };
+}
+/**
+ * Reads a graph file into Cytoscape element definitions.
+ * Without `styles`, a GEXF `viz:color`, `viz:size`, `viz:shape` and `viz:thickness` also become data fields
+ * (`data.color` as four numbers from 0 to 1, `data.size`, `data.shape`, `data.thickness`); these fields are
+ * deprecated and are removed in the next major release: import with `styles: true`, whose stylesheet draws them.
+ * With `styles: true` they are left out of data.
+ * @param input - the file as text, bytes, a stream or chunks
+ * @param format - the format, or "auto" to sniff it
+ * @param options - graph-io's import options
+ * @returns the elements, the direction, the format and graph-io's report
+ * @throws ImportError (from graph-io) when the file cannot be read, or when it yields no node and reports an error
+ */
+export async function importElements(input, format = "auto", options = {}) {
+    // fetch().arrayBuffer() and File.arrayBuffer() give an ArrayBuffer, which graph-io does not take
+    const { applyStyles: _apply, importId, ...graphOptions } = options;
+    const r = await importGraph(input instanceof ArrayBuffer ? new Uint8Array(input) : input, {
+        ...graphOptions,
+        format,
+    });
+    // most text sniffs as CSV, so a file that is not a graph at all reads as an empty one with errors
+    if (r.snapshot.nodeCount === 0 && r.report.errorCount > 0) {
+        const first = r.report.issues.find((i) => i.severity === "error");
+        throw new ImportError(`nothing could be read from the input as ${r.format}: ${first?.code ?? "E_IMPORT"}: ${first?.message ?? ""}`, r.report, { format: r.format });
+    }
+    const warnings = [];
+    const elements = snapshotToElements(r.snapshot, ({ domain, from, to }) => warnings.push({
+        category: "coercion",
+        severity: "warning",
+        code: "W_COLUMN_RENAMED",
+        message: `${domain} attribute "${from}" renamed to "${to}": Cytoscape reserves the data field "${from}"`,
+        line: null,
+        element: from,
+    }), (id, takenBy) => warnings.push({
+        category: "coercion",
+        severity: "warning",
+        code: "W_EDGE_ID_DROPPED",
+        message: `edge id "${id}" is already the id of ${takenBy === "node" ? "a node" : "an earlier edge"}; Cytoscape gives this edge a new id`,
+        line: null,
+        element: id,
+    }), r.styles !== undefined && r.styles !== null);
+    // each format spells its coordinates its own way (yEd: a box's top-left corner, y down; Gephi: the
+    // center, y up); graph-io's extractPositions reads them all as the center with y up, and Cytoscape's y
+    // grows downward
+    const positions = extractPositions(registry.importer(r.format), r.snapshot, r.report);
+    for (let i = 0; i < r.snapshot.nodeCount; i++) {
+        const el = elements[i];
+        const x = positions?.usable === true ? positions.coords[3 * i] : Number.NaN;
+        if (Number.isNaN(x)) {
+            delete el.position;
+        }
+        else {
+            el.position = { x, y: flipY(positions?.coords[3 * i + 1] ?? 0) };
+        }
+    }
+    let styled = {};
+    if (r.styles !== undefined && r.styles !== null) {
+        imports++;
+        const em = toCytoscapeStylesheet(r.styles, { importId: importId ?? String(imports) });
+        const n = r.snapshot.nodeCount;
+        const at = (per, i) => i < n ? per.node[i] : per.edge[i - n];
+        elements.forEach((el, i) => Object.assign(el.data, at(em.elementData, i)));
+        styled = { stylesheet: em.stylesheet, bypass: elements.map((_el, i) => at(em.bypass, i)) };
+        warnings.push(...em.notes.map(styleIssue));
+    }
+    const report = warnings.length === 0
+        ? r.report
+        : {
+            ...r.report,
+            issues: [...r.report.issues, ...warnings],
+            warningCount: r.report.warningCount + warnings.length,
+        };
+    return { elements, directed: r.snapshot.directed, format: r.format, report, ...styled };
+}
+/** The loss notes about something graphtyImport always gives back (see lostForCytoscape). */
+const CYTOSCAPE_KEEPS = new Set([
+    "W_ID_TEXT_TYPE",
+    "W_ID_RENUMBERED",
+    "W_CSV_NODE_ORDER",
+    "W_STORAGE_CLASS_CHANGED",
+]);
+/**
+ * Whether a graph-io loss note is a loss for a Cytoscape graph. graph-io's notes describe its own snapshot read back
+ * by itself; graphtyImport restores some of what they report:
+ * - W_ID_TEXT_TYPE: every id is turned back into a string;
+ * - W_ID_RENUMBERED (Pajek) and W_CSV_NODE_ORDER: graphtyImport gives the nodes their original ids back, and a
+ *   Cytoscape node is known by its id, not by its place in the file;
+ * - W_STORAGE_CLASS_CHANGED: text stored as a dictionary or as plain strings reads back as the same strings;
+ * - W_COLUMN_NAME_CHANGED on the edge `id`, the `parent` or the `position` (DOT reads them back as "key",
+ *   "graphty.parent" and "pos"): they are read back by their role, as the edge id, `data.parent` and the position;
+ * - W_ROLE_DROPPED on `label`: the values read back as `data.label`, and Cytoscape has no label role to lose.
+ * @param n - the note
+ * @returns false for a note about something graphtyImport gives back
+ */
+function lostForCytoscape(n) {
+    if (CYTOSCAPE_KEEPS.has(n.code)) {
+        return false;
+    }
+    if (n.code === "W_COLUMN_NAME_CHANGED" && (n.column === "id" || n.column === "parent" || n.column === "position")) {
+        return false;
+    }
+    return !(n.code === "W_ROLE_DROPPED" && n.column === "label");
+}
+/**
+ * The core a collection belongs to (`eles.cy()`, which Cytoscape's typings leave out).
+ * @param eles - the collection
+ * @returns the core
+ */
+function coreOf(eles) {
+    return eles.cy();
+}
+/**
+ * A core's style.
+ * @param cy - the core
+ * @returns the style, or undefined when the core has styles disabled (headless without `styleEnabled`)
+ */
+function styleOf(cy) {
+    return cy.style();
+}
+/**
+ * The styles of a collection as its core draws them: the core's stylesheet, with each element's `ele.style()` as
+ * the truth.
+ * @param eles - the collection
+ * @param snapshot - the collection as elementsToSnapshot() wrote it
+ * @returns the styles, or null when the core has styles disabled (a headless core without `styleEnabled`)
+ */
+function coreStyles(eles, snapshot) {
+    const style = styleOf(coreOf(eles));
+    if (style === undefined) {
+        return null;
+    }
+    const nodes = eles.nodes();
+    const edges = exportedEdges(eles);
+    return readCytoscapeStyles({
+        elements: { nodes: nodes.jsons(), edges: edges.jsons() },
+        style: style.json(),
+        rendered: [...nodes.map((n) => n.style()), ...edges.map((e) => e.style())],
+        snapshot,
+    });
+}
+/**
+ * W_STYLE_LAYER_FLATTENED for each property written per element instead of as a rule (a function-valued one).
+ * @param extracted - the core's styles
+ * @returns the notes
+ */
+function flattened(extracted) {
+    return extracted.styles.notes
+        .filter((n) => n.code === STYLE_ISSUE.LAYER_FLATTENED)
+        .map((n) => ({
+        code: n.code,
+        message: n.message,
+        column: null,
+        count: n.params.count,
+        ...(n.params.target === "node" || n.params.target === "edge"
+            ? { style: { target: n.params.target, property: n.params.property } }
+            : {}),
+    }));
+}
+/**
+ * W_STYLES_NOT_EXPORTED when the core has a stylesheet of its own (one a new core does not have), or when styles were
+ * asked for and the core has none to give (a headless core without `styleEnabled`).
+ * @param cy - the core
+ * @param asked - whether the export asked for the styles
+ * @returns the note, or none
+ */
+function notExported(cy, asked) {
+    const style = styleOf(cy);
+    if (style === undefined) {
+        return asked
+            ? [
+                {
+                    code: STYLE_ISSUE.NOT_EXPORTED,
+                    message: "no styles are written: the core has styles disabled; create it with { styleEnabled: true }",
+                    column: null,
+                    count: null,
+                },
+            ]
+            : [];
+    }
+    const fresh = new cy.constructor({ headless: true, styleEnabled: true });
+    const own = JSON.stringify(style.json()) !== JSON.stringify(styleOf(fresh)?.json());
+    fresh.destroy();
+    return own
+        ? [
+            {
+                code: STYLE_ISSUE.NOT_EXPORTED,
+                message: "the core's stylesheet is not written; export with { styles: true } to write it",
+                column: null,
+                count: null,
+            },
+        ]
+        : [];
+}
+/** The formats that hold only integer node ids: a graph whose ids are all integers is written with them as they are. */
+const INTEGER_ID_FORMATS = new Set(["gml", "cx2"]);
+/**
+ * Writes a collection as a graph file: every data field, each node's position and compound parent, and each
+ * edge's id, as far as the format holds them (`onLoss` hears about the rest).
+ * @param eles - the nodes and the edges between them
+ * @param format - the format
+ * @param options - graph-io's export options for the format, plus `directed`
+ * @returns the file's text; rejects (a TypeError) when `eles` is not a collection
+ */
+export async function exportElements(eles, format, options = {}) {
+    // importElements returns definitions, which this cannot read without a core to build them
+    if (typeof eles?.nodes !== "function") {
+        throw new TypeError("exportElements needs a Cytoscape collection; wrap element definitions with cytoscape({ headless: true, elements }).elements()");
+    }
+    const { directed, onLoss, styles, ...rest } = options;
+    const snapshot = elementsToSnapshot(eles, {
+        directed,
+        format,
+        integerIds: INTEGER_ID_FORMATS.has(format),
+    });
+    const extracted = styles === true ? coreStyles(eles, snapshot) : null;
+    const graphOptions = {
+        sanitizeIds: "mangle",
+        ...(format === "json" ? { dialect: "cytoscape" } : {}),
+        ...rest,
+        ...(extracted === null ? {} : { styles: extracted }),
+    };
+    if (onLoss !== undefined) {
+        const notes = [
+            ...(extracted === null ? notExported(coreOf(eles), styles === true) : flattened(extracted)),
+            ...checkExport(snapshot, format, graphOptions).filter(lostForCytoscape),
+        ];
+        if (notes.length > 0) {
+            onLoss(notes);
+        }
+    }
+    return exportGraphToString(snapshot, format, graphOptions);
+}
+//# sourceMappingURL=io.js.map

package/dist/io.js.map

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