@graphty/cytoscape-extensions 0.0.28 → 0.0.30

package/dist/gpu.d.ts

@@ -0,0 +1,149 @@
+/**
+ * WebGPU acceleration: detection, device acquisition, reuse, device-loss recovery and disposal, per Cytoscape core.
+ *
+ * The package @graphty/webgpu-graph-algorithms is a regular dependency, but nothing here imports it statically.
+ * The first call that could use a GPU, in a runtime that has WebGPU (or might: Node, where the optional `webgpu`
+ * package brings Dawn), loads it with a dynamic import of "#gpu-platform". The package's `imports` field maps that specifier to the Node
+ * build or the browser build, so a bundler puts the GPU code in a chunk of its own that a CPU-only page never
+ * fetches, and a browser bundle never sees the Node build's `import("webgpu")`.
+ *
+ * The rule the whole module follows: the GPU-or-CPU decision is made once, up front, before any work starts.
+ * A failure of work that already started on the GPU (a lost device, an out-of-memory) is thrown to the caller,
+ * never finished quietly on the CPU. The next call acquires a fresh device.
+ */
+import type { AlgorithmAccelerator } from "@graphty/algorithms";
+import type { GraphSnapshot } from "@graphty/graph-format";
+import type { LayoutAccelerator } from "@graphty/layout";
+import type { Core } from "cytoscape";
+/** The accelerator a provider hands over: both CPU packages' injection seams, plus snapshot release and disposal. */
+export type GpuAccelerator = AlgorithmAccelerator & LayoutAccelerator & {
+    release(s: GraphSnapshot): void;
+    dispose(): void;
+};
+/** A device a provider acquired. */
+export interface AcquiredGpu {
+    readonly accelerator: GpuAccelerator;
+    /** "vendor / description", for the backend report. */
+    readonly device: string;
+    /** Resolves (with the reason) when the device is lost, including when it is destroyed by dispose(). */
+    readonly lost: Promise<string>;
+}
+/** Thrown by a provider that declined up front (no WebGPU, no adapter, a software-only or incorrect device). */
+export declare class GpuUnavailableError extends Error {
+    /** E_NO_WEBGPU, E_NO_ADAPTER, E_SOFTWARE_ONLY, E_DEVICE_INCORRECT, ... */
+    readonly code: string;
+    /** What the user can change to get the GPU, when there is something; null when nothing they do would help. */
+    readonly fix: string | null;
+    /**
+     * Creates the error.
+     * @param code - the reason code
+     * @param message - the reason in words
+     * @param fix - what the user can change to get the GPU, or null
+     */
+    constructor(code: string, message: string, fix?: string | null);
+}
+/**
+ * The error a call on a destroyed Cytoscape core rejects with, or a layout run started on one emits as layouterror.
+ * @returns the error, `code` "E_CORE_DESTROYED"
+ */
+export declare function coreDestroyedError(): Error & {
+    readonly code: "E_CORE_DESTROYED";
+};
+/** Probes, constructs and verifies a device, or throws GpuUnavailableError. */
+export interface GpuProvider {
+    acquire(): Promise<AcquiredGpu>;
+}
+/**
+ * Per call: "auto" (default) uses the GPU when one is available and runs the CPU otherwise; "off" always runs the CPU;
+ * "require" throws when no GPU is available instead of running the CPU.
+ */
+export type GpuMode = "auto" | "off" | "require";
+/**
+ * Throws when a `gpu` option is not one of the modes, so a misspelled "require" cannot quietly run on the CPU.
+ * @param name - the method or layout, for the message
+ * @param mode - the caller's `gpu` option
+ * @throws TypeError when the option is set to anything but "auto", "off" or "require"
+ */
+export declare function checkGpuMode(name: string, mode: unknown): void;
+/** Which implementation ran, and why the CPU when it was the CPU. */
+export interface Backend {
+    readonly ran: "gpu" | "cpu";
+    /** Why the CPU ran; null when the GPU ran. */
+    readonly reason: string | null;
+    /** The GPU device, when one was acquired (also when the options kept the work on the CPU). */
+    readonly device: string | null;
+}
+/** Options of `configureWebGpu`, for every core. */
+export interface WebGpuOptions {
+    /**
+     * Accept a software adapter (llvmpipe, SwiftShader, WARP). Default false: a software adapter is usually slower
+     * than the CPU implementation, so the CPU runs and the result says why.
+     */
+    readonly acceptSoftware?: boolean;
+    /** Node only: a substring of the Dawn adapter name to pick ("llvmpipe", "4070"). Ignored in a browser. */
+    readonly adapter?: string;
+}
+/**
+ * Graphs with at least this many nodes are where the GPU is expected to pay off. One of them running on the CPU for
+ * a reason the user could fix logs a one-time console warning; smaller graphs never do.
+ */
+export declare const GPU_SIZE_FLOOR = 5000;
+/** A core's GPU decision: an acquired device, or the reason there is none. */
+interface Decision {
+    readonly gpu: AcquiredGpu | null;
+    readonly reason: string | null;
+    /** When the CPU was chosen for a reason the user could fix: the fix. */
+    readonly fix?: string | null;
+}
+/**
+ * Sets the WebGPU options of every core. Each core disposes its device and decides again on its next call.
+ * @param o - see WebGpuOptions
+ */
+export declare function configureWebGpu(o?: WebGpuOptions): void;
+/**
+ * Test seam: replaces the platform's provider.
+ * @param p - the provider; null disables WebGPU; undefined restores the platform's provider
+ */
+export declare function registerGpuProvider(p: GpuProvider | null | undefined): void;
+/**
+ * Why a run in this mode takes the CPU without asking for a device, so it can stay synchronous.
+ * @param mode - the caller's mode
+ * @returns the decision when it is already known to be the CPU, or null when a device has to be asked for
+ */
+export declare function cpuWithoutAsking(mode?: GpuMode): Decision | null;
+/**
+ * The core's device, acquiring one on first use and again after a loss. One device per core, reused by every call.
+ * The first call in the process loads @graphty/webgpu-graph-algorithms.
+ * @param cy - the core
+ * @param mode - the caller's mode
+ * @returns the device (null for the CPU) and the reason when null
+ * @throws Error under "require" when no device is available, and when the core was destroyed
+ */
+export declare function gpuFor(cy: Core, mode?: GpuMode): Promise<Decision>;
+/**
+ * Warns once per configuration when a graph at or above GPU_SIZE_FLOOR runs on the CPU for a reason the user could
+ * fix. Small graphs, gpu: "off" and reasons nobody can fix stay quiet.
+ * @param d - the decision the run started with
+ * @param nodeCount - the graph's node count
+ */
+export declare function warnIfFixable(d: Decision, nodeCount: number): void;
+/**
+ * An accelerator that records whether any of its methods was called, so the run can report which implementation
+ * answered. The CPU packages' dispatchers choose the CPU silently when the options or the graph need it.
+ * @param acc - the accelerator
+ * @returns the recording accelerator and the flag reader
+ */
+export declare function recording<T extends object>(acc: T): {
+    accelerator: T;
+    used(): boolean;
+};
+/**
+ * The backend report of a finished run.
+ * @param d - the decision the run started with
+ * @param usedGpu - whether the dispatcher called the accelerator
+ * @param why - the reason the dispatcher kept the work on the CPU, when it did
+ * @returns the report
+ */
+export declare function backendOf(d: Decision, usedGpu: boolean, why: string): Backend;
+export {};
+//# sourceMappingURL=gpu.d.ts.map

package/dist/gpu.d.ts.map

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

package/dist/gpu.js

@@ -0,0 +1,312 @@
+/**
+ * WebGPU acceleration: detection, device acquisition, reuse, device-loss recovery and disposal, per Cytoscape core.
+ *
+ * The package @graphty/webgpu-graph-algorithms is a regular dependency, but nothing here imports it statically.
+ * The first call that could use a GPU, in a runtime that has WebGPU (or might: Node, where the optional `webgpu`
+ * package brings Dawn), loads it with a dynamic import of "#gpu-platform". The package's `imports` field maps that specifier to the Node
+ * build or the browser build, so a bundler puts the GPU code in a chunk of its own that a CPU-only page never
+ * fetches, and a browser bundle never sees the Node build's `import("webgpu")`.
+ *
+ * The rule the whole module follows: the GPU-or-CPU decision is made once, up front, before any work starts.
+ * A failure of work that already started on the GPU (a lost device, an out-of-memory) is thrown to the caller,
+ * never finished quietly on the CPU. The next call acquires a fresh device.
+ */
+import { loadPart } from "./lazy.js";
+import { onSnapshotsDropped } from "./snapshot.js";
+/** Thrown by a provider that declined up front (no WebGPU, no adapter, a software-only or incorrect device). */
+export class GpuUnavailableError extends Error {
+    /**
+     * Creates the error.
+     * @param code - the reason code
+     * @param message - the reason in words
+     * @param fix - what the user can change to get the GPU, or null
+     */
+    constructor(code, message, fix = null) {
+        super(message);
+        this.name = "GpuUnavailableError";
+        this.code = code;
+        this.fix = fix;
+    }
+}
+/**
+ * The error a call on a destroyed Cytoscape core rejects with, or a layout run started on one emits as layouterror.
+ * @returns the error, `code` "E_CORE_DESTROYED"
+ */
+export function coreDestroyedError() {
+    return Object.assign(new Error("graphty: the Cytoscape core was destroyed"), { code: "E_CORE_DESTROYED" });
+}
+const GPU_MODES = ["auto", "off", "require"];
+/**
+ * Throws when a `gpu` option is not one of the modes, so a misspelled "require" cannot quietly run on the CPU.
+ * @param name - the method or layout, for the message
+ * @param mode - the caller's `gpu` option
+ * @throws TypeError when the option is set to anything but "auto", "off" or "require"
+ */
+export function checkGpuMode(name, mode) {
+    if (mode !== undefined && !GPU_MODES.includes(mode)) {
+        // a string quoted, so "require " shows its space; anything else by its value or its type
+        const plain = mode === null || typeof mode === "number" || typeof mode === "boolean";
+        const shown = plain ? String(mode) : `a value of type ${typeof mode}`;
+        const got = typeof mode === "string" ? JSON.stringify(mode) : shown;
+        throw new TypeError(`${name}: gpu must be "auto", "off" or "require"; got ${got}`);
+    }
+}
+/**
+ * Graphs with at least this many nodes are where the GPU is expected to pay off. One of them running on the CPU for
+ * a reason the user could fix logs a one-time console warning; smaller graphs never do.
+ */
+export const GPU_SIZE_FLOOR = 5000;
+let options = {};
+/** Set by tests in place of the platform's provider; null disables WebGPU, undefined restores the platform's. */
+let override;
+/** The provider being loaded or loaded, for the current options. */
+let loading = null;
+/** The same, once settled, so a run that cannot use the GPU can stay synchronous. */
+let loaded = null;
+let warned = false;
+const cores = new WeakMap();
+/**
+ * Sets the WebGPU options of every core. Each core disposes its device and decides again on its next call.
+ * @param o - see WebGpuOptions
+ */
+export function configureWebGpu(o = {}) {
+    options = { ...o };
+    loading = null;
+    loaded = null;
+    warned = false;
+}
+/**
+ * Test seam: replaces the platform's provider.
+ * @param p - the provider; null disables WebGPU; undefined restores the platform's provider
+ */
+export function registerGpuProvider(p) {
+    configureWebGpu(options);
+    override = p;
+}
+/**
+ * Why this runtime certainly has no WebGPU, without loading anything.
+ * @returns the reason, or null when it has WebGPU or might (Node, with the optional `webgpu` package)
+ */
+function noWebGpu() {
+    const nav = globalThis.navigator;
+    if (nav?.gpu !== undefined && nav.gpu !== null) {
+        return null;
+    }
+    const proc = globalThis.process;
+    return proc?.versions?.node === undefined ? "this runtime has no WebGPU (navigator.gpu is undefined)" : null;
+}
+/**
+ * The provider, loading the GPU package on first use.
+ * @returns the provider, or why there is none
+ */
+function source() {
+    if (loading === null) {
+        const none = noWebGpu();
+        if (override !== undefined || none !== null) {
+            // known without loading anything, so known synchronously
+            loaded = override ?? { reason: none ?? "WebGPU was disabled", fix: null };
+            loading = Promise.resolve(loaded);
+        }
+        else {
+            const p = loadPart(import("#gpu-platform"), "an ...Async method or a simulation layout").then((m) => m.gpuProvider(options), (e) => ({
+                reason: `@graphty/webgpu-graph-algorithms did not load: ${messageOf(e)}`,
+                fix: "check that @graphty/webgpu-graph-algorithms is installed and that your bundler serves its chunk",
+            }));
+            loading = p;
+            void p.then((s) => {
+                if (loading === p) {
+                    loaded = s;
+                }
+            });
+        }
+    }
+    return loading;
+}
+/**
+ * Whether a source is a provider.
+ * @param s - the source
+ * @returns true for a provider
+ */
+function isProvider(s) {
+    return "acquire" in s;
+}
+/**
+ * The message of a thrown value.
+ * @param e - what was thrown
+ * @returns its message
+ */
+function messageOf(e) {
+    return e instanceof Error ? e.message : String(e);
+}
+/**
+ * Disposes a decision's device once the decision settles. A decision that failed holds no device, and its error
+ * already reached the caller that awaited it.
+ * @param decision - the decision, or null when there is none
+ */
+function disposeWhenDecided(decision) {
+    decision?.then((d) => d.gpu?.accelerator.dispose(), () => undefined);
+}
+/**
+ * The per-core state; the first call subscribes to the core's destroy event.
+ * @param cy - the core
+ * @returns its state
+ */
+function coreGpu(cy) {
+    let g = cores.get(cy);
+    if (g === undefined) {
+        const created = { decision: null, by: null, destroyed: false };
+        cy.one("destroy", () => {
+            created.destroyed = true;
+            disposeWhenDecided(created.decision);
+            created.decision = null;
+        });
+        cores.set(cy, created);
+        g = created;
+    }
+    return g;
+}
+/**
+ * Acquires a device for a core: probe, construct, verify; wires loss, snapshot release and destroy.
+ * @param cy - the core
+ * @param g - its state
+ * @param p - the provider
+ * @returns the decision
+ */
+async function decide(cy, g, p) {
+    let gpu;
+    try {
+        gpu = await p.acquire();
+    }
+    catch (e) {
+        // Up-front detection: nothing has run yet, so the CPU is the honest answer, with the reason
+        const fix = e instanceof GpuUnavailableError ? e.fix : null;
+        return { gpu: null, reason: `no usable WebGPU device: ${messageOf(e)}`, fix };
+    }
+    if (g.destroyed) {
+        gpu.accelerator.dispose();
+        return { gpu: null, reason: "the core was destroyed" };
+    }
+    const unsubscribe = onSnapshotsDropped(cy, (dropped) => {
+        for (const s of dropped) {
+            gpu.accelerator.release(s);
+        }
+    });
+    const self = g.decision;
+    void gpu.lost.then(() => {
+        unsubscribe();
+        // The next call acquires a new device. A device the core's own destroy disposed also resolves `lost`, and
+        // a decision already replaced is left alone.
+        if (g.decision === self) {
+            g.decision = null;
+        }
+    });
+    return { gpu, reason: null };
+}
+/**
+ * Why a run in this mode takes the CPU without asking for a device, so it can stay synchronous.
+ * @param mode - the caller's mode
+ * @returns the decision when it is already known to be the CPU, or null when a device has to be asked for
+ */
+export function cpuWithoutAsking(mode = "auto") {
+    if (mode === "off") {
+        return { gpu: null, reason: 'gpu: "off" was requested', fix: null };
+    }
+    if (override === null) {
+        return { gpu: null, reason: "WebGPU was disabled", fix: null };
+    }
+    if (loading === null && override === undefined) {
+        const none = noWebGpu();
+        if (none !== null) {
+            return { gpu: null, reason: none, fix: null };
+        }
+    }
+    return loaded === null || isProvider(loaded) ? null : { gpu: null, ...loaded };
+}
+/**
+ * The core's device, acquiring one on first use and again after a loss. One device per core, reused by every call.
+ * The first call in the process loads @graphty/webgpu-graph-algorithms.
+ * @param cy - the core
+ * @param mode - the caller's mode
+ * @returns the device (null for the CPU) and the reason when null
+ * @throws Error under "require" when no device is available, and when the core was destroyed
+ */
+export async function gpuFor(cy, mode = "auto") {
+    let d = cpuWithoutAsking(mode);
+    if (d === null) {
+        // subscribed to the core's destroy before the first await, so a destroy during the wait is seen
+        const g = coreGpu(cy);
+        const pending = source();
+        const src = loaded ?? (await pending);
+        if (!isProvider(src)) {
+            d = { gpu: null, ...src };
+        }
+        else {
+            if (g.destroyed) {
+                throw coreDestroyedError();
+            }
+            if (g.decision === null || g.by !== src) {
+                disposeWhenDecided(g.decision);
+                // deferred one tick so decide() sees its own promise in g.decision
+                g.decision = Promise.resolve().then(() => decide(cy, g, src));
+                g.by = src;
+            }
+            d = await g.decision;
+        }
+    }
+    if (mode === "require" && d.gpu === null) {
+        throw new Error(`graphty: gpu: "require" but ${d.reason ?? "no device"}`);
+    }
+    return d;
+}
+/**
+ * Warns once per configuration when a graph at or above GPU_SIZE_FLOOR runs on the CPU for a reason the user could
+ * fix. Small graphs, gpu: "off" and reasons nobody can fix stay quiet.
+ * @param d - the decision the run started with
+ * @param nodeCount - the graph's node count
+ */
+export function warnIfFixable(d, nodeCount) {
+    if (warned || d.gpu !== null || d.fix === undefined || d.fix === null || nodeCount < GPU_SIZE_FLOOR) {
+        return;
+    }
+    warned = true;
+    console.warn(`graphty: a ${nodeCount.toLocaleString("en-US")}-node graph ran on the CPU because ${d.reason ?? "no GPU"}. ` +
+        `To use the GPU: ${d.fix}. Pass gpu: "off" to run on the CPU without this warning.`);
+}
+/**
+ * An accelerator that records whether any of its methods was called, so the run can report which implementation
+ * answered. The CPU packages' dispatchers choose the CPU silently when the options or the graph need it.
+ * @param acc - the accelerator
+ * @returns the recording accelerator and the flag reader
+ */
+export function recording(acc) {
+    let used = false;
+    const accelerator = new Proxy(acc, {
+        get(target, key, receiver) {
+            const v = Reflect.get(target, key, receiver);
+            if (typeof v !== "function" || key === "release" || key === "dispose") {
+                return v;
+            }
+            return (...args) => {
+                used = true;
+                return v.apply(target, args);
+            };
+        },
+    });
+    return { accelerator, used: () => used };
+}
+/**
+ * The backend report of a finished run.
+ * @param d - the decision the run started with
+ * @param usedGpu - whether the dispatcher called the accelerator
+ * @param why - the reason the dispatcher kept the work on the CPU, when it did
+ * @returns the report
+ */
+export function backendOf(d, usedGpu, why) {
+    if (d.gpu === null) {
+        return { ran: "cpu", reason: d.reason, device: null };
+    }
+    return usedGpu
+        ? { ran: "gpu", reason: null, device: d.gpu.device }
+        : { ran: "cpu", reason: why, device: d.gpu.device };
+}
+//# sourceMappingURL=gpu.js.map

package/dist/gpu.js.map

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

package/dist/graph-data.d.ts

@@ -0,0 +1,101 @@
+/**
+ * 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 type { ImportInput, ImportReport } from "@graphty/graph-io";
+import type { FetchDatasetOptions } from "@graphty/graph-samples";
+import type { CollectionReturnValue } from "cytoscape";
+import type { CytoscapeStylesheetRule, ExportFormat, ExportOptions, ImportFormat, ImportOptions } from "./io.js";
+import type { GeneratorName, GeneratorOptions } from "./samples.js";
+/** What graphtyGenerate and graphtyDataset add to the core. */
+export interface AddedGraph {
+    /** The added nodes and edges. */
+    readonly elements: CollectionReturnValue;
+    /** Whether the graph is directed: pass it as `directed` to the algorithms. */
+    readonly directed: boolean;
+}
+/** What graphtyImport adds to the core. */
+export interface ImportedGraph extends AddedGraph {
+    /** 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: true`, the file's styles as a Cytoscape.js stylesheet whose every rule applies only to this
+     * import's elements (they hold its id in `data.graphty_import`). `applyStyles: true` has already appended it to
+     * the core's stylesheet; otherwise append it yourself, rule by rule:
+     * `for (const r of stylesheet) cy.style().selector(r.selector).style(r.style); cy.style().update()`.
+     * Absent without `styles`.
+     */
+    readonly stylesheet?: CytoscapeStylesheetRule[];
+}
+/** The core methods `cytoscape.use(graphtyCytoscape)` adds for getting graphs in and out. */
+export interface GraphtyGraphData {
+    /**
+     * Adds a generated graph: `cy.graphtyGenerate("barabasi-albert", { n: 500, m: 2, seed: 1 })`. Node ids are
+     * "0", "1", ... and edge ids "e0", "e1", ...; ground-truth columns (`community`, ...) become data fields and
+     * weights `data.weight`. Nodes are placed at the origin (run a layout next), except that a generator's
+     * coordinates (`positions: true` on the lattices; the geometric generators) become node positions, in the
+     * generator's own units. Throws, adding nothing, when the core already holds one of the graph's node ids.
+     */
+    graphtyGenerate<N extends GeneratorName>(name: N, options: GeneratorOptions<N>): Promise<AddedGraph>;
+    /**
+     * Adds a sample dataset: `cy.graphtyDataset("karate")`, downloaded from graphty.app (`options.baseUrl` for a
+     * mirror of your own). Throws, adding nothing, when the core already holds one of the graph's node ids.
+     * `options.signal` cancels it: once aborted, it rejects with the signal's reason and adds nothing, whatever
+     * `options.fetch` does with the signal.
+     */
+    graphtyDataset(name: string, options?: FetchDatasetOptions): Promise<AddedGraph>;
+    /**
+     * Adds the graph in a file: GEXF, GraphML, GML, DOT, Pajek, CSV, JSON, Neo4j, XGMML, CX2, CX, OBO or a
+     * Cytoscape session (`.cys`, as bytes). Every attribute becomes a data field, and positions in the file become
+     * node positions, the way up the program that wrote the file draws them (a yEd box's top-left corner is
+     * moved to its center). Throws, adding
+     * nothing, when the core already holds one of the graph's node ids.
+     * `{ styles: true }` also reads the file's colors, sizes, shapes, ... and returns them as `stylesheet`;
+     * `{ styles: true, applyStyles: true }` draws them too (the core needs `styleEnabled` when headless).
+     * Without `styles`, a GEXF `viz:color`, `viz:size`, `viz:shape` and `viz:thickness` also become data fields;
+     * these fields are deprecated and are removed in the next major release: use `styles: true`, which leaves
+     * them out of data and draws them through the stylesheet.
+     */
+    graphtyImport(input: ImportInput | ArrayBuffer, format?: ImportFormat, options?: ImportOptions): Promise<ImportedGraph>;
+    /**
+     * Writes the graph as a file's text: every data field, each node's position and parent, and each edge's id, as
+     * far as the format holds them (`options.onLoss` hears about the rest). Hidden elements are written too. On a
+     * collection: its nodes, and those of its edges whose two ends are among them. `{ styles: true }` also writes
+     * how the core draws each element, so graphtyImport with `styles: true` draws the file the same.
+     */
+    graphtyExport(format: ExportFormat, options?: ExportOptions): Promise<string>;
+}
+declare module "cytoscape" {
+    interface Core extends GraphtyGraphData {
+    }
+    interface CollectionAlgorithms {
+        /** Writes the collection's nodes, and its edges whose two ends are among them, as a file's text. */
+        graphtyExport: GraphtyGraphData["graphtyExport"];
+    }
+}
+type Register = (type: string, name: string, registrant: unknown) => void;
+/**
+ * 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 declare class IdTakenError extends Error {
+    /** Always "E_ID_TAKEN". */
+    readonly code = "E_ID_TAKEN";
+    /** The first node id of the new graph that the core already holds. */
+    readonly id: string;
+    /**
+     * Creates the error.
+     * @param id - the clashing id
+     */
+    constructor(id: string);
+}
+/**
+ * Registers graphtyGenerate, graphtyDataset, graphtyImport and graphtyExport.
+ * @param cytoscape - the cytoscape function
+ */
+export declare function registerGraphData(cytoscape: Register): void;
+export {};
+//# sourceMappingURL=graph-data.d.ts.map

package/dist/graph-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-data.d.ts","sourceRoot":"","sources":["../src/graph-data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAc,qBAAqB,EAA2B,MAAM,WAAW,CAAC;AAG5F,OAAO,KAAK,EAAE,uBAAuB,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEjH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IACvB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC9B;AAQD,2CAA2C;AAC3C,MAAM,WAAW,aAAc,SAAQ,UAAU;IAC7C,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,uBAAuB,EAAE,CAAC;CACnD;AAED,6FAA6F;AAC7F,MAAM,WAAW,gBAAgB;IAC7B;;;;;;OAMG;IACH,eAAe,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrG;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjF;;;;;;;;;;;OAWG;IACH,aAAa,CACT,KAAK,EAAE,WAAW,GAAG,WAAW,EAChC,MAAM,CAAC,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE,aAAa,GACxB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjF;AAED,OAAO,QAAQ,WAAW,CAAC;IAEvB,UAAU,IAAK,SAAQ,gBAAgB;KAAG;IAC1C,UAAU,oBAAoB;QAC1B,oGAAoG;QACpG,aAAa,EAAE,gBAAgB,CAAC,eAAe,CAAC,CAAC;KACpD;CACJ;AAED,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;AAE1E;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;OAGG;gBACS,EAAE,EAAE,MAAM;CAQzB;AAuED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,QAAQ,GAAG,IAAI,CA8D3D"}