@graphty/graph-io 0.3.42 → 0.3.44

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

@@ -0,0 +1,208 @@
+/**
+ * The types of `@graphty/graph-io/positions`: the neutral form every format's stored node
+ * coordinates are read into, and how a column or an importer says how its coordinates are spelled.
+ *
+ * The neutral convention: every coordinate is the node's center, y grows upward, in the file's own
+ * length unit (`units`), with 3 components (z = 0 when the file stored 2, or when every node has the
+ * same z).
+ */
+import type { GraphTool, LengthUnit } from "../common/units.js";
+import type { PositionNoteCode } from "./codes.js";
+export type { GraphTool, LengthUnit } from "../common/units.js";
+/**
+ * Which way a file's y coordinate grows. "down" is screen order (yEd, Cytoscape, Pajek, d3), "up"
+ * is math order (Gephi, Graphviz, graph-io's own position columns).
+ * @category Positions
+ */
+export type YAxis = "up" | "down";
+/**
+ * What a stored node coordinate points at: the node's center, or the top-left corner of its box
+ * (yEd), which needs the node's width and height to find the center.
+ * @category Positions
+ */
+export type PositionAnchor = "center" | "top-left";
+/**
+ * How a role-`position` column's values are spelled, as optional fields of the column's
+ * `meta.extra`. A missing field means y up, center, `"file"` units: what the Cytoscape-family,
+ * GEXF and DOT columns already hold.
+ * @category Positions
+ */
+export interface PositionColumnExtra {
+    /** The unit of the coordinates. */
+    readonly units?: LengthUnit;
+    /**
+     * How many px (points) one unit of the coordinates is, when `units` is "file" but the file's
+     * unit is a known length: 72 for Graphviz input inches. Lets a reader draw the coordinates in
+     * the same unit as the file's px style lengths; the coordinates themselves stay as written.
+     */
+    readonly pxPerUnit?: number;
+    /** How many coordinates the file wrote per node: 2, or 3 when it stored a z. */
+    readonly sourceDims?: 2 | 3;
+    /** Which way y grows; "down" is flipped to y up. */
+    readonly yAxis?: YAxis;
+    /** What the coordinate points at; "top-left" is moved to the center using `width` and `height`. */
+    readonly anchor?: PositionAnchor;
+    /** The name of the node column holding each node's width, for a top-left anchor. */
+    readonly width?: string;
+    /** The name of the node column holding each node's height, for a top-left anchor. */
+    readonly height?: string;
+    /** A z the file centers its depth on (Pajek's 0.5): subtracted from a real z before any flip. */
+    readonly zOrigin?: number;
+    /**
+     * The file writes (0, 0) for a node it has no position for (NetworkX's Pajek writer): when other
+     * rows are placed, a (0, 0) shared by two or more rows counts as unplaced.
+     */
+    readonly zeroUnplaced?: boolean;
+}
+/**
+ * A group container's box, as an importer's `positions()` hook gives it: (`x`, `y`) is where the
+ * box's anchor is, spelled like the node coordinates (the same y direction and anchor).
+ * @category Positions
+ */
+export interface ImporterGroupBox {
+    /** The container node, by index. */
+    readonly node: number;
+    /** The box. */
+    readonly box: {
+        /** The box's anchor, x. */
+        readonly x: number;
+        /** The box's anchor, y. */
+        readonly y: number;
+        /** The box's width. */
+        readonly width: number;
+        /** The box's height. */
+        readonly height: number;
+    };
+}
+/**
+ * What an importer's `positions()` hook returns: where its coordinates are and how they are spelled.
+ *
+ * The simple form names two (or three) plain numeric node columns:
+ * `{ x: "x", y: "y", yAxis: "down", units: "px" }`. The advanced form names a 3-component column
+ * (`column`) and may add the anchor, size columns, group boxes, a median node size and the tool.
+ * @category Positions
+ */
+export interface ImporterPositions extends PositionColumnExtra {
+    /** A plain numeric node column holding x (simple form). */
+    readonly x?: string;
+    /** A plain numeric node column holding y (simple form). */
+    readonly y?: string;
+    /** A plain numeric node column holding z (simple form); omit for a 2D file. */
+    readonly z?: string;
+    /** A 3-component node column holding the coordinates (advanced form); defaults to the role-`position` column. */
+    readonly column?: string;
+    /** Group container boxes the file stores apart from the node coordinates (Graphviz cluster `bb`). */
+    readonly groups?: readonly ImporterGroupBox[];
+    /** The median node diameter in the file's unit, when the importer knows it better than the size columns. */
+    readonly medianNodeSize?: number | null;
+    /** The tool that wrote the file, when the importer knows it better than `meta.creator`. */
+    readonly tool?: GraphTool | null;
+}
+/**
+ * What an importer's `positions()` hook is given besides the snapshot.
+ * @category Positions
+ */
+export interface PositionReadContext {
+    /** Aborts a long read. */
+    readonly signal: AbortSignal | null;
+}
+/**
+ * A note about the stored positions: a code with its parameters, never a sentence for a reader.
+ * `message` is graph-io's English for its own logs.
+ * @category Positions
+ */
+export interface PositionNote {
+    /** The condition. */
+    readonly code: PositionNoteCode;
+    /** How many elements (or columns) it covers, and up to 8 examples. */
+    readonly params: {
+        /** How many elements (or columns) it covers. */
+        readonly count: number;
+        /** Up to 8 of their ids (or column names). */
+        readonly samples: readonly string[];
+    };
+    /** The node indexes it covers, or only their count when it is about the file as a whole. */
+    readonly elements: readonly number[] | {
+        /** How many it covers. */
+        readonly count: number;
+    };
+    /** graph-io's English; never shown to a reader by graphty-element. */
+    readonly message: string;
+}
+/**
+ * A group container's box in the neutral convention: (`x`, `y`) is the box's center, y up.
+ * @category Positions
+ */
+export interface FilePositionGroup {
+    /** The container node, by index. */
+    readonly node: number;
+    /** The box: center, width and height in the file's unit. */
+    readonly box: {
+        /** The box's center, x. */
+        readonly x: number;
+        /** The box's center, y. */
+        readonly y: number;
+        /** The box's width. */
+        readonly width: number;
+        /** The box's height. */
+        readonly height: number;
+    };
+}
+/**
+ * A file's stored node coordinates in the neutral convention: the node's center, y up, in the
+ * file's own unit, 3 components per node.
+ * @category Positions
+ */
+export interface FilePositions {
+    /** The shape version of this object. */
+    readonly version: 1;
+    /** Where the coordinates came from: the format, the tool that wrote the file, and the y direction it used. */
+    readonly source: {
+        /** The format that read the file. */
+        readonly format: string;
+        /** The tool that wrote the file, or null when the file does not say. */
+        readonly tool: GraphTool | null;
+        /** Which way y grew in the file; every coordinate here has y up. */
+        readonly yAxis: YAxis;
+    };
+    /** The unit of every coordinate and size. */
+    readonly units: LengthUnit;
+    /**
+     * How many px (points) one unit is, when `units` is "file" but the file's unit is a known
+     * length (Graphviz input inches: 72); absent otherwise. Multiply a coordinate by it to compare
+     * it with the file's px style lengths.
+     */
+    readonly pxPerUnit?: number;
+    /** The median node diameter, in `units`, when the file stores node sizes; else null. */
+    readonly medianNodeSize: number | null;
+    /** 3 when the nodes differ in z, else 2 (z is then 0). */
+    readonly dims: 2 | 3;
+    /** x, y, z per node, by node index (3 * nodeCount); NaN for a node with no position. */
+    readonly coords: Float64Array;
+    /** The nodes with a position. */
+    readonly placed: number;
+    /** The nodes that need one: every node except group containers the file gives no box. */
+    readonly total: number;
+    /** False when nothing is stored, or every node sits on one point (coords are then all NaN). */
+    readonly usable: boolean;
+    /** The box around every placed node, or null when none is placed. */
+    readonly bounds: {
+        /** The smallest x, y and z. */
+        readonly min: readonly [number, number, number];
+        /** The largest x, y and z. */
+        readonly max: readonly [number, number, number];
+    } | null;
+    /** Group containers with a box. */
+    readonly groups: readonly FilePositionGroup[];
+    /** What could not be read as written. */
+    readonly notes: readonly PositionNote[];
+}
+/**
+ * Options of `extractPositions()`.
+ * @category Positions
+ */
+export interface ExtractPositionsOptions {
+    /** Aborts the read; it throws the signal's reason. */
+    readonly signal?: AbortSignal | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/positions/types.js

@@ -0,0 +1,10 @@
+/**
+ * The types of `@graphty/graph-io/positions`: the neutral form every format's stored node
+ * coordinates are read into, and how a column or an importer says how its coordinates are spelled.
+ *
+ * The neutral convention: every coordinate is the node's center, y grows upward, in the file's own
+ * length unit (`units`), with 3 components (z = 0 when the file stored 2, or when every node has the
+ * same z).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/positions/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/positions/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/registry.d.ts

@@ -8,6 +8,8 @@
  */
 import { type FreezeOptions, type FreezeReport, type GraphBuilderOptions, type GraphSnapshot } from "@graphty/graph-format";
 import { type FormatName, type SniffHints, type SniffResult } from "./sniff.js";
+import { type StyleImportOptions } from "./styles/io/generic.js";
+import type { ExtractedStyles } from "./styles/types.js";
 import { type CommonExportOptions, type CommonImportOptions, type ExportCapabilities, type GraphChoiceOptions, type GraphExporter, type GraphImporter, type GraphListing, type ImportInput, type ImportReport, type LossNote } from "./types.js";
 /**
  * The input is in no format graph-io can read (or none of the formats you registered, for your own FormatRegistry).
@@ -79,6 +81,13 @@ export interface ImportGraphOptions extends CommonImportOptions, GraphChoiceOpti
      * @defaultValue 16777216
      */
     readonly maxEmptyCells?: number | undefined;
+    /**
+     * Read the file's styles too: `true`, or `{ toolDefaults: false }` to leave out the defaults of the program
+     * that wrote the file. The styles are in `result.styles`; the graph, the report and every export are the same
+     * either way.
+     * @defaultValue false
+     */
+    readonly styles?: boolean | StyleImportOptions | undefined;
     /** Format-specific options, passed to the importer as they are. */
     readonly [formatOption: string]: unknown;
 }
@@ -113,6 +122,12 @@ export interface ImportGraphResult {
      * can ignore it. It is not enumerable, so `console.log(result)` and `{ ...result }` leave it out.
      */
     readonly freeze: FreezeReport;
+    /**
+     * The file's styles, when you passed the `styles` option: the rules that reproduce how the program that wrote
+     * the file draws each node and edge, read by the importer that read the file. Null when the file has none.
+     * Absent without the option.
+     */
+    readonly styles?: ExtractedStyles | null;
 }
 /**
  * Options for loadFromUrl(): everything importGraph() accepts, plus the fetch request settings.
@@ -176,6 +191,13 @@ export interface FormatInfo {
  * @category Saving
  */
 export interface ExportGraphOptions extends CommonExportOptions {
+    /**
+     * Write these styles too (`result.styles` of an import, or styles built for this graph): each element's look in
+     * the format's own style slots and, where the format can keep them, the rules, so importing the file back
+     * rebuilds them. What the format cannot hold is a W_STYLE_ note of checkExport(). Styles read from or built for a
+     * different graph fail with E_STYLES_MISMATCH before anything is written.
+     */
+    readonly styles?: ExtractedStyles | null | undefined;
     /** Format-specific options, passed to the exporter as they are. */
     readonly [formatOption: string]: unknown;
 }
@@ -328,6 +350,14 @@ export declare class FormatRegistry {
      * @returns the encoded chunks
      */
     exportGraph(snapshot: GraphSnapshot, format: FormatName, options?: ExportGraphOptions | CommonExportOptions): AsyncIterable<Uint8Array>;
+    /**
+     * An export with styles worked out, or null when no styles were given (the export is then exactly as before).
+     * @param snapshot - the graph
+     * @param format - the format name
+     * @param options - the caller's options
+     * @returns the exporter, the snapshot and options to hand it, the style losses and any refusal
+     */
+    private styled;
     /**
      * Write a snapshot in a format, as one string.
      * @param snapshot - the snapshot

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

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

package/dist/src/registry.js

@@ -8,7 +8,7 @@
  */
 import { GraphFormatError, } from "@graphty/graph-format";
 import { CellBudgetBuilder, maxEmptyCellsOption } from "./common/cell-budget.js";
-import { EDGES_MERGED_CODE, EMPTY_INPUT_CODE, FETCH_CODE, OPTION_IGNORED_CODE, SELF_LOOPS_DROPPED_CODE, UNKNOWN_OPTION_CODE, WEIGHT_NOT_FOUND_CODE, } from "./common/codes.js";
+import { EDGES_MERGED_CODE, EMPTY_INPUT_CODE, FETCH_CODE, OPTION_IGNORED_CODE, SELF_LOOPS_DROPPED_CODE, STYLES_NOT_IMPORTED_CODE, UNKNOWN_OPTION_CODE, WEIGHT_NOT_FOUND_CODE, } from "./common/codes.js";
 import { abortable, foreignKind, lockReader, normalizeInput, throwIfAborted } from "./common/input.js";
 import { chooseGraph, resolveImportOptions } from "./common/options.js";
 import { agree, plural } from "./common/plural.js";
@@ -28,6 +28,8 @@ import { oboExporter, oboImporter } from "./formats/obo/index.js";
 import { pajekExporter, pajekImporter } from "./formats/pajek/index.js";
 import { xgmmlExporter, xgmmlImporter } from "./formats/xgmml/index.js";
 import { rankFormats, SNIFF_HEAD_BYTES } from "./sniff.js";
+import { extractStyles } from "./styles/io/generic.js";
+import { isKeptGraphtyProperty, prepareStyleExport } from "./styles/io/writer.js";
 import { ImportError, } from "./types.js";
 /**
  * The input is in no format graph-io can read (or none of the formats you registered, for your own FormatRegistry).
@@ -70,6 +72,7 @@ const FUNCTION_OPTIONS = new Set([
     "sanitizeIds",
     "selfLoops",
     "signal",
+    "styles",
     "weightDtype",
     "weightFrom",
 ]);
@@ -81,6 +84,7 @@ const REGISTRY_KEYS = new Set([
     "builder",
     "freeze",
     "maxEmptyCells",
+    "styles",
 ]);
 /**
  * A registry of importers and exporters by format name. Registration order is the tie-break
@@ -423,7 +427,38 @@ export class FormatRegistry {
      * @returns the encoded chunks
      */
     exportGraph(snapshot, format, options) {
-        return this.exporter(format).export(snapshot, options);
+        const styled = this.styled(snapshot, format, options);
+        if (styled === null) {
+            return this.exporter(format).export(snapshot, options);
+        }
+        if (styled.refusal !== null) {
+            return refuse(styled.refusal);
+        }
+        return styled.exporter.export(styled.snapshot, styled.options);
+    }
+    /**
+     * An export with styles worked out, or null when no styles were given (the export is then exactly as before).
+     * @param snapshot - the graph
+     * @param format - the format name
+     * @param options - the caller's options
+     * @returns the exporter, the snapshot and options to hand it, the style losses and any refusal
+     */
+    styled(snapshot, format, options) {
+        const styles = options?.styles;
+        if (styles === undefined || styles === null) {
+            return null;
+        }
+        const exporter = this.exporter(format);
+        const { styles: _given, ...rest } = options;
+        const prepared = prepareStyleExport(snapshot, exporter, styles, rest);
+        return {
+            exporter,
+            snapshot: prepared.snapshot,
+            options: prepared.input === null ? rest : { ...rest, styles: prepared.input },
+            plain: rest,
+            notes: prepared.notes,
+            refusal: prepared.refusal,
+        };
     }
     /**
      * Write a snapshot in a format, as one string.
@@ -433,7 +468,14 @@ export class FormatRegistry {
      * @returns the whole document
      */
     async exportGraphToString(snapshot, format, options) {
-        return this.exporter(format).exportToString(snapshot, options);
+        const styled = this.styled(snapshot, format, options);
+        if (styled === null) {
+            return this.exporter(format).exportToString(snapshot, options);
+        }
+        if (styled.refusal !== null) {
+            throw refusalError(styled.refusal);
+        }
+        return styled.exporter.exportToString(styled.snapshot, styled.options);
     }
     /**
      * Write a snapshot in a format as one buffer of UTF-8 bytes; see the top-level
@@ -470,7 +512,26 @@ export class FormatRegistry {
      * @returns the loss notes, empty when the export is exact
      */
     checkExport(snapshot, format, options) {
-        const notes = this.exporter(format).check(snapshot, options);
+        const styled = this.styled(snapshot, format, options);
+        let notes;
+        if (styled === null) {
+            notes = this.exporter(format).check(snapshot, options);
+        }
+        else if (styled.refusal === null) {
+            // a property graph-io already reports as not written is reported once, whoever else notices
+            const key = (n) => `${n.code}\u0000${n.style?.target ?? ""}\u0000${n.style?.property ?? ""}`;
+            const reported = new Set(styled.notes.filter((n) => n.style !== undefined).map(key));
+            notes = [
+                ...styled.exporter
+                    .check(styled.snapshot, styled.options)
+                    .filter((n) => n.style === undefined ||
+                    (!reported.has(key(n)) && !isKeptGraphtyProperty(n, styled.exporter))),
+                ...styled.notes,
+            ];
+        }
+        else {
+            notes = [...styled.exporter.check(snapshot, styled.plain), styled.refusal];
+        }
         const unknown = this.unknownOptions(options);
         if (unknown.length === 0) {
             return notes;
@@ -549,7 +610,7 @@ export class FormatRegistry {
                 mimeTypes: importer?.mimeTypes ?? exporter?.mimeTypes ?? [],
                 canImport: importer !== undefined,
                 canExport: exporter !== undefined,
-                capabilities: exporter?.capabilities ?? null,
+                capabilities: capabilitiesOf(exporter),
             });
         });
     }
@@ -1014,22 +1075,82 @@ function result(chosen, builder, report, options) {
         throw freezeFailure(err, report);
     }
     const { warnings } = chosen;
+    const wanted = options.styles;
+    let styles;
+    if (wanted !== undefined && wanted !== false) {
+        styles = extractStyles(chosen.importer, frozen.snapshot, report, {
+            signal: options.signal,
+            toolDefaults: typeof wanted === "object" ? wanted.toolDefaults : undefined,
+        });
+    }
+    const read = styles !== undefined && chosen.importer.styles !== undefined ? withoutStylesNotImported(report) : report;
     const result = {
         format: chosen.importer.format,
         sniff: chosen.sniff,
         snapshot: frozen.snapshot,
         report: withFreezeWarnings(weightNotFound(warnings.length === 0
-            ? report
+            ? read
             : Object.freeze({
-                ...report,
-                issues: Object.freeze([...warnings, ...report.issues]),
-                warningCount: report.warningCount + warnings.length,
+                ...read,
+                issues: Object.freeze([...warnings, ...read.issues]),
+                warningCount: read.warningCount + warnings.length,
             }), frozen.snapshot, options.weightFrom), frozen.report),
     };
+    if (styles !== undefined) {
+        Object.assign(result, { styles });
+    }
     // not enumerable: it holds one entry per edge, and console.log(result) should show the graph, not that
     Object.defineProperty(result, "freeze", { value: frozen.report, enumerable: false });
     return Object.freeze(result);
 }
+/**
+ * A report without its W_STYLES_NOT_IMPORTED warnings: the importer read the styles it would have named.
+ * @param report - the importer's report
+ * @returns the report, a copy only when it held such a warning
+ */
+function withoutStylesNotImported(report) {
+    const issues = report.issues.filter((i) => i.code !== STYLES_NOT_IMPORTED_CODE);
+    if (issues.length === report.issues.length) {
+        return report;
+    }
+    return Object.freeze({
+        ...report,
+        issues: Object.freeze(issues),
+        warningCount: report.warningCount - (report.issues.length - issues.length),
+    });
+}
+/**
+ * The error an export refused for its styles throws.
+ * @param note - the refusal note
+ * @returns the error
+ */
+function refusalError(note) {
+    return new GraphFormatError("E_UNSUPPORTED", note.message, { code: note.code });
+}
+/**
+ * Chunks that fail on the first read, before any byte: an export refused for its styles.
+ * @param note - the refusal note
+ * @returns chunks whose first read rejects
+ */
+function refuse(note) {
+    return {
+        [Symbol.asyncIterator]: () => ({ next: () => Promise.reject(refusalError(note)) }),
+    };
+}
+/**
+ * The capabilities listFormats() reports for an exporter: its table plus, when it writes styles, their capabilities.
+ * @param exporter - the exporter, or undefined
+ * @returns the capabilities, or null
+ */
+function capabilitiesOf(exporter) {
+    if (exporter === undefined) {
+        return null;
+    }
+    if (exporter.styles === undefined) {
+        return exporter.capabilities;
+    }
+    return Object.freeze({ ...exporter.capabilities, styles: exporter.styles.capabilities });
+}
 /**
  * The message of a W_UNKNOWN_OPTION warning or note.
  * @param name - the option name