@graphty/graph-io 0.3.47 → 0.3.49

package/dist/styles.js

@@ -1,226 +1,9 @@
-import { t as StyleNotes, y as featuresOf, s as styleFingerprint } from "./chunks/block-DiGq58c3.js";
-import { z, S, A, a, B, T, q, r, C } from "./chunks/block-DiGq58c3.js";
-import { S as StyleBudget, e as evaluateCytoscapeJs } from "./chunks/emit-CwU8cUmG.js";
-import { C as C2, t } from "./chunks/emit-CwU8cUmG.js";
-import { p as planStyles } from "./chunks/generic-Dq1ntt9q.js";
-import { M, e } from "./chunks/generic-Dq1ntt9q.js";
-const CYTOSCAPE_ANNOTATIONS_COLUMN = "__Annotations";
-const TYPE_PREFIX = "org.cytoscape.view.presentation.annotations.";
-const SHAPES = /* @__PURE__ */ new Map([
-  ["rectangle", "rectangle"],
-  ["roundedrectangle", "round-rectangle"],
-  ["rounded_rectangle", "round-rectangle"],
-  ["ellipse", "ellipse"],
-  ["triangle", "triangle"],
-  ["diamond", "diamond"],
-  ["pentagon", "pentagon"],
-  ["hexagon", "hexagon"],
-  ["octagon", "octagon"],
-  ["parallelogram", "parallelogram"],
-  ["star5", "star"],
-  ["star6", "star"]
-]);
-const ARROW_ORDER = [
-  "circle",
-  "triangle",
-  "vee",
-  "diamond",
-  "triangle-open",
-  "none",
-  "tee",
-  "triangle",
-  "triangle",
-  "triangle",
-  "tee",
-  "other:x"
-];
-const ARROW_NAMES = /* @__PURE__ */ new Map([
-  ["circle", "circle"],
-  ["closed arrow", "triangle"],
-  ["concave arrow", "vee"],
-  ["diamond", "diamond"],
-  ["open arrow", "triangle-open"],
-  ["no arrow", "none"],
-  ["pipe", "tee"],
-  ["triangle", "triangle"],
-  ["t", "tee"],
-  ["x", "other:x"]
-]);
-function readAnnotations(snapshot) {
-  const { graph } = snapshot;
-  const cell = graph.has(CYTOSCAPE_ANNOTATIONS_COLUMN) ? graph.value(CYTOSCAPE_ANNOTATIONS_COLUMN, 0) : null;
-  const entries = cellStrings(cell);
-  const fields = entries.map(parseEntry);
-  const byId = new Map(fields.map((f, i) => [f.get("uuid") ?? String(i), f]));
-  const annotations = [];
-  const skipped = /* @__PURE__ */ new Set();
-  fields.forEach((f, i) => {
-    const read = readOne(f, String(i), byId);
-    if (read === null) {
-      skipped.add((f.get("type") ?? "").replace(TYPE_PREFIX, ""));
-    } else {
-      annotations.push(...read);
-    }
-  });
-  return { annotations, skipped: [...skipped] };
-}
-function cellStrings(cell) {
-  if (typeof cell === "string") {
-    return cell.split(/[\r\n]+/).filter((s) => s !== "");
-  }
-  if (cell !== null && typeof cell === "object" && Symbol.iterator in cell) {
-    return Array.from(cell).filter((s) => typeof s === "string" && s !== "");
-  }
-  return [];
-}
-function parseEntry(entry) {
-  const out = /* @__PURE__ */ new Map();
-  for (const part of entry.split("|")) {
-    const eq = part.indexOf("=");
-    if (eq > 0) {
-      out.set(part.slice(0, eq), part.slice(eq + 1));
-    }
-  }
-  return out;
-}
-function readOne(f, index, byId) {
-  const type = (f.get("type") ?? "").replace(TYPE_PREFIX, "");
-  const zoom = positive(f.get("zoom")) ?? 1;
-  const base = {
-    id: f.get("uuid") ?? index,
-    layer: f.get("canvas") === "background" ? "background" : "foreground",
-    z: num(f.get("z")) ?? 0
-  };
-  switch (type) {
-    case "ShapeAnnotation":
-      return [shapeOf(f, base, zoom)];
-    case "TextAnnotation":
-      return [textOf(f, base, zoom, { x: num(f.get("x")) ?? 0, y: -(num(f.get("y")) ?? 0) }, "top-left")];
-    case "BoundedTextAnnotation": {
-      const shape = shapeOf(f, base, zoom);
-      return [shape, textOf(f, { ...base, id: `${base.id}:text` }, zoom, shape.center, "center")];
-    }
-    case "ArrowAnnotation":
-      return arrowOf(f, base, zoom, byId);
-    default:
-      return null;
-  }
-}
-function shapeOf(f, base, zoom) {
-  const x = num(f.get("x")) ?? 0;
-  const y = num(f.get("y")) ?? 0;
-  const width = (positive(f.get("width")) ?? 0) / zoom;
-  const height = (positive(f.get("height")) ?? 0) / zoom;
-  const fill = javaColor(f.get("fillColor"));
-  const border = javaColor(f.get("edgeColor")) ?? { color: "#000000", alpha: 1 };
-  return {
-    ...base,
-    kind: "shape",
-    center: { x: x + width / 2, y: -(y + height / 2) },
-    width,
-    height,
-    shape: SHAPES.get((f.get("shapeType") ?? "rectangle").toLowerCase()) ?? "rectangle",
-    fill: fill?.color ?? null,
-    fillOpacity: fill === null ? 0 : fill.alpha * percent(f.get("fillOpacity")),
-    borderColor: border.color,
-    borderOpacity: border.alpha * percent(f.get("edgeOpacity")),
-    borderWidth: (num(f.get("edgeThickness")) ?? 1) / zoom
-  };
-}
-function textOf(f, base, zoom, at, anchor) {
-  const style = num(f.get("fontStyle")) ?? 0;
-  const color = javaColor(f.get("color")) ?? { color: "#000000", alpha: 1 };
-  return {
-    ...base,
-    kind: "text",
-    text: f.get("text") ?? "",
-    at,
-    anchor,
-    fontSize: (positive(f.get("fontSize")) ?? 12) / zoom,
-    fontFamily: f.get("fontFamily") ?? "sans-serif",
-    bold: (style & 1) !== 0,
-    italic: (style & 2) !== 0,
-    color: color.color,
-    opacity: color.alpha
-  };
-}
-function arrowOf(f, base, zoom, byId) {
-  const target = f.get("targetAnnotation");
-  const to = point(f.get("targetPoint")) ?? point(f.get("targetNode")) ?? centerOf(byId.get(target ?? ""), zoom);
-  if (to === null) {
-    return null;
-  }
-  const corner = { x: num(f.get("x")) ?? 0, y: num(f.get("y")) ?? 0 };
-  const source = centerOf(byId.get(f.get("sourceAnnotation") ?? ""), zoom) ?? corner;
-  const from = { x: to.x > corner.x ? corner.x : source.x, y: to.y > corner.y ? corner.y : source.y };
-  const color = javaColor(f.get("lineColor")) ?? { color: "#000000", alpha: 1 };
-  return [
-    {
-      ...base,
-      kind: "arrow",
-      from: { x: from.x, y: -from.y },
-      to: { x: to.x, y: -to.y },
-      color: color.color,
-      opacity: color.alpha * percent(f.get("lineOpacity")),
-      width: (positive(f.get("lineThickness")) ?? 1) / zoom,
-      sourceArrow: arrowShape(f.get("sourceType")),
-      targetArrow: arrowShape(f.get("targetType")),
-      sourceSize: positive(f.get("sourceSize")) ?? 1,
-      targetSize: positive(f.get("targetSize")) ?? 1
-    }
-  ];
-}
-function centerOf(f, zoom) {
-  if (f === void 0) {
-    return null;
-  }
-  const x = num(f.get("x"));
-  const y = num(f.get("y"));
-  if (x === null || y === null) {
-    return null;
-  }
-  return { x: x + (positive(f.get("width")) ?? 0) / zoom / 2, y: y + (positive(f.get("height")) ?? 0) / zoom / 2 };
-}
-function arrowShape(raw) {
-  if (raw === void 0) {
-    return "none";
-  }
-  const n = num(raw);
-  if (n !== null) {
-    return ARROW_ORDER[n] ?? "triangle";
-  }
-  return ARROW_NAMES.get(raw.trim().toLowerCase()) ?? "triangle";
-}
-function point(raw) {
-  const [x, y] = (raw ?? "").split(",").map((s) => num(s));
-  return x === null || x === void 0 || y === null || y === void 0 ? null : { x, y };
-}
-function javaColor(raw) {
-  const n = num(raw);
-  if (n === null || !Number.isInteger(n)) {
-    return null;
-  }
-  const argb = n >>> 0;
-  return {
-    color: `#${(argb & 16777215).toString(16).padStart(6, "0")}`,
-    alpha: (argb >>> 24) / 255
-  };
-}
-function percent(raw) {
-  const n = num(raw);
-  return n === null ? 1 : Math.min(1, Math.max(0, n / 100));
-}
-function num(raw) {
-  if (raw === void 0 || raw.trim() === "") {
-    return null;
-  }
-  const n = Number(raw);
-  return Number.isFinite(n) ? n : null;
-}
-function positive(raw) {
-  const n = num(raw);
-  return n !== null && n > 0 ? n : null;
-}
+import { p as planStyles } from "./chunks/generic-ymWCETAJ.js";
+import { M, e, r, a } from "./chunks/generic-ymWCETAJ.js";
+import { h as StyleNotes, t as featuresOf, o as styleFingerprint } from "./chunks/block-iptrlMBb.js";
+import { u, S, v, b, w, T, l, x, r as r2, y } from "./chunks/block-iptrlMBb.js";
+import { S as StyleBudget, e as evaluateCytoscapeJs } from "./chunks/emit-BwHQkZle.js";
+import { C, t } from "./chunks/emit-BwHQkZle.js";
 const FUNCTION = () => null;
 function withFunctions(style) {
   if (!Array.isArray(style)) {
@@ -237,8 +20,8 @@ function withFunctions(style) {
     }
     const copy = /* @__PURE__ */ Object.create(null);
     for (const name of Object.keys(props)) {
-      const v = props[name];
-      copy[name] = v === "fn" ? FUNCTION : v;
+      const v2 = props[name];
+      copy[name] = v2 === "fn" ? FUNCTION : v2;
     }
     return { selector: e2.selector, style: copy };
   });
@@ -268,7 +51,7 @@ function readCytoscapeStyles(input) {
       }
     }
   }
-  const r2 = evaluateCytoscapeJs({
+  const r3 = evaluateCytoscapeJs({
     elements: input.elements,
     style: withFunctions(input.style),
     snapshot: input.snapshot,
@@ -285,8 +68,8 @@ function readCytoscapeStyles(input) {
       dialect: "cytoscape-js",
       tool: "cytoscape-js",
       units: "px",
-      node: { values: r2.node.values, rules: r2.node.rules, columns: r2.node.columns },
-      edge: { values: r2.edge.values, rules: r2.edge.rules, columns: r2.edge.columns },
+      node: { values: r3.node.values, rules: r3.node.rules, columns: r3.node.columns },
+      edge: { values: r3.edge.values, rules: r3.edge.rules, columns: r3.edge.columns },
       fingerprint: styleFingerprint(s)
     },
     { node: featuresOf(s, "node"), edge: featuresOf(s, "edge") },
@@ -295,28 +78,36 @@ function readCytoscapeStyles(input) {
       notes,
       budget,
       signal: input.signal,
-      rawColumns: { node: r2.node.rawColumns, edge: r2.edge.rawColumns }
+      rawColumns: { node: r3.node.rawColumns, edge: r3.edge.rawColumns }
     }
   );
 }
+const BYPASS_NAMESPACES = /* @__PURE__ */ new Set(["cx.bypass", "cx2.bypass"]);
+function isStyleSlotColumn(meta) {
+  const { origin } = meta;
+  return typeof origin?.namespace === "string" && BYPASS_NAMESPACES.has(origin.namespace) || meta.dtype === "json" && origin?.type === "graphics" && origin.namespace === "xgmml";
+}
 export {
-  C2 as CYTOSCAPE_IMPORT_KEY,
-  z as MAX_STYLE_BLOCK_LENGTH,
+  C as CYTOSCAPE_IMPORT_KEY,
+  u as MAX_STYLE_BLOCK_LENGTH,
   M as MAX_STYLE_RULES,
   S as STYLE_BLOCK_NAME,
-  A as STYLE_ENUMS,
-  a as STYLE_ISSUE,
-  B as STYLE_PROPERTIES,
+  v as STYLE_ENUMS,
+  b as STYLE_ISSUE,
+  w as STYLE_PROPERTIES,
   T as TOOL_DEFAULTS,
   e as extractStyles,
   featuresOf,
-  q as isStyleValue,
+  isStyleSlotColumn,
+  l as isStyleValue,
+  x as matchPredicate,
   planStyles,
-  readAnnotations,
+  r as readAnnotations,
   readCytoscapeStyles,
-  r as resolveStyles,
+  a as readImageAnnotations,
+  r2 as resolveStyles,
   styleFingerprint,
   t as toCytoscapeStylesheet,
-  C as toolDefaults
+  y as toolDefaults
 };
 //# sourceMappingURL=styles.js.map

package/dist/styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"styles.js","sources":["../src/styles/annotations.ts","../src/styles/cyjs/live.ts"],"sourcesContent":["/**\n * The annotations a file draws beside its graph: shapes, text notes and arrows that are not nodes or edges. Cytoscape\n * desktop keeps them in the network's `__Annotations` column (sessions, XGMML, CX and CX2 all carry it), one\n * `key=value|key=value` string per annotation; this reads them as neutral facts in the position convention (y up,\n * the file's own units), so they line up with `extractPositions()`.\n */\n\nimport type { GraphSnapshot } from \"@graphty/graph-format\";\n\nimport type { StyleArrowShape, StyleColor, StyleNodeShape } from \"./types.js\";\n\n/**\n * A point in the position convention: y up, in the file's own units.\n * @category Styles\n */\nexport interface AnnotationPoint {\n    /** The x coordinate. */\n    readonly x: number;\n    /** The y coordinate, y up. */\n    readonly y: number;\n}\n\n/**\n * What every annotation has.\n * @category Styles\n */\nexport interface AnnotationBase {\n    /** The file's id for the annotation, or its index when the file gives none. */\n    readonly id: string;\n    /** Whether it is drawn behind the graph or in front of it. */\n    readonly layer: \"background\" | \"foreground\";\n    /** Its drawing order within its layer, lowest first. */\n    readonly z: number;\n}\n\n/**\n * A filled, outlined shape.\n * @category Styles\n */\nexport interface ShapeAnnotation extends AnnotationBase {\n    /** Which kind of annotation this is: always \"shape\". */\n    readonly kind: \"shape\";\n    /** The box's center. */\n    readonly center: AnnotationPoint;\n    /** The box's width. */\n    readonly width: number;\n    /** The box's height. */\n    readonly height: number;\n    /** The outline's shape. */\n    readonly shape: StyleNodeShape;\n    /** The fill color, or null for none. */\n    readonly fill: StyleColor | null;\n    /** The fill's opacity, 0..1. */\n    readonly fillOpacity: number;\n    /** The outline's color. */\n    readonly borderColor: StyleColor;\n    /** The outline's opacity, 0..1. */\n    readonly borderOpacity: number;\n    /** The outline's width. */\n    readonly borderWidth: number;\n}\n\n/**\n * A line of text.\n * @category Styles\n */\nexport interface TextAnnotation extends AnnotationBase {\n    /** Which kind of annotation this is: always \"text\". */\n    readonly kind: \"text\";\n    /** The text. */\n    readonly text: string;\n    /** Where the text is placed: the top-left corner of its box, or its center. */\n    readonly at: AnnotationPoint;\n    /** What `at` is. */\n    readonly anchor: \"top-left\" | \"center\";\n    /** The font size, in the file's units. */\n    readonly fontSize: number;\n    /** The font family. */\n    readonly fontFamily: string;\n    /** Whether the text is bold. */\n    readonly bold: boolean;\n    /** Whether the text is italic. */\n    readonly italic: boolean;\n    /** The text color. */\n    readonly color: StyleColor;\n    /** The text's opacity, 0..1. */\n    readonly opacity: number;\n}\n\n/**\n * A line between two points, with an arrowhead at either end.\n * @category Styles\n */\nexport interface ArrowAnnotation extends AnnotationBase {\n    /** Which kind of annotation this is: always \"arrow\". */\n    readonly kind: \"arrow\";\n    /** Where the line starts. */\n    readonly from: AnnotationPoint;\n    /** Where it ends. */\n    readonly to: AnnotationPoint;\n    /** The line color. */\n    readonly color: StyleColor;\n    /** The line's opacity, 0..1. */\n    readonly opacity: number;\n    /** The line width. */\n    readonly width: number;\n    /** The arrowhead at the start. */\n    readonly sourceArrow: StyleArrowShape;\n    /** The arrowhead at the end. */\n    readonly targetArrow: StyleArrowShape;\n    /** The start's arrowhead size as a factor of the normal size. */\n    readonly sourceSize: number;\n    /** The end's arrowhead size as a factor of the normal size. */\n    readonly targetSize: number;\n}\n\n/**\n * One annotation.\n * @category Styles\n */\nexport type GraphAnnotation = ShapeAnnotation | TextAnnotation | ArrowAnnotation;\n\n/**\n * A file's annotations, and the kinds it holds that are not read (images, groups of annotations), by the file's\n * own type name, once each.\n * @category Styles\n */\nexport interface FileAnnotations {\n    /** The annotations read, in the file's order. */\n    readonly annotations: readonly GraphAnnotation[];\n    /** The file's type names of the annotations not read. */\n    readonly skipped: readonly string[];\n}\n\n/** The graph column Cytoscape desktop keeps its annotations in. */\nconst CYTOSCAPE_ANNOTATIONS_COLUMN = \"__Annotations\";\n\nconst TYPE_PREFIX = \"org.cytoscape.view.presentation.annotations.\";\n\n/** Cytoscape's annotation shape names, lowercase, as neutral shapes. */\nconst SHAPES: ReadonlyMap<string, StyleNodeShape> = new Map<string, StyleNodeShape>([\n    [\"rectangle\", \"rectangle\"],\n    [\"roundedrectangle\", \"round-rectangle\"],\n    [\"rounded_rectangle\", \"round-rectangle\"],\n    [\"ellipse\", \"ellipse\"],\n    [\"triangle\", \"triangle\"],\n    [\"diamond\", \"diamond\"],\n    [\"pentagon\", \"pentagon\"],\n    [\"hexagon\", \"hexagon\"],\n    [\"octagon\", \"octagon\"],\n    [\"parallelogram\", \"parallelogram\"],\n    [\"star5\", \"star\"],\n    [\"star6\", \"star\"],\n]);\n\n/**\n * Cytoscape's annotation arrowheads, by the position in its `ArrowType` list (older sessions) and by name (newer\n * ones), lowercase.\n */\nconst ARROW_ORDER: readonly StyleArrowShape[] = [\n    \"circle\",\n    \"triangle\",\n    \"vee\",\n    \"diamond\",\n    \"triangle-open\",\n    \"none\",\n    \"tee\",\n    \"triangle\",\n    \"triangle\",\n    \"triangle\",\n    \"tee\",\n    \"other:x\",\n];\nconst ARROW_NAMES: ReadonlyMap<string, StyleArrowShape> = new Map<string, StyleArrowShape>([\n    [\"circle\", \"circle\"],\n    [\"closed arrow\", \"triangle\"],\n    [\"concave arrow\", \"vee\"],\n    [\"diamond\", \"diamond\"],\n    [\"open arrow\", \"triangle-open\"],\n    [\"no arrow\", \"none\"],\n    [\"pipe\", \"tee\"],\n    [\"triangle\", \"triangle\"],\n    [\"t\", \"tee\"],\n    [\"x\", \"other:x\"],\n]);\n\n/**\n * The annotations a graph holds, from the column Cytoscape desktop keeps them in.\n * @param snapshot - the graph\n * @returns the annotations; none when the graph has the column empty or not at all\n * @category Styles\n */\nexport function readAnnotations(snapshot: GraphSnapshot): FileAnnotations {\n    const { graph } = snapshot;\n    const cell = graph.has(CYTOSCAPE_ANNOTATIONS_COLUMN) ? graph.value(CYTOSCAPE_ANNOTATIONS_COLUMN, 0) : null;\n    const entries = cellStrings(cell);\n    const fields = entries.map(parseEntry);\n    const byId = new Map(fields.map((f, i) => [f.get(\"uuid\") ?? String(i), f]));\n    const annotations: GraphAnnotation[] = [];\n    const skipped = new Set<string>();\n    fields.forEach((f, i) => {\n        const read = readOne(f, String(i), byId);\n        if (read === null) {\n            skipped.add((f.get(\"type\") ?? \"\").replace(TYPE_PREFIX, \"\"));\n        } else {\n            annotations.push(...read);\n        }\n    });\n    return { annotations, skipped: [...skipped] };\n}\n\n/**\n * A cell's strings: a list cell's items, or the lines of a text cell.\n * @param cell - the cell\n * @returns the strings\n */\nfunction cellStrings(cell: unknown): string[] {\n    if (typeof cell === \"string\") {\n        return cell.split(/[\\r\\n]+/).filter((s) => s !== \"\");\n    }\n    if (cell !== null && typeof cell === \"object\" && Symbol.iterator in cell) {\n        return Array.from(cell as Iterable<unknown>).filter((s): s is string => typeof s === \"string\" && s !== \"\");\n    }\n    return [];\n}\n\n/**\n * One annotation string's fields.\n * @param entry - `key=value|key=value`\n * @returns the fields\n */\nfunction parseEntry(entry: string): Map<string, string> {\n    const out = new Map<string, string>();\n    for (const part of entry.split(\"|\")) {\n        const eq = part.indexOf(\"=\");\n        if (eq > 0) {\n            out.set(part.slice(0, eq), part.slice(eq + 1));\n        }\n    }\n    return out;\n}\n\n/**\n * One annotation as neutral facts; a bounded text annotation is a shape and its text.\n * @param f - its fields\n * @param index - its position, its id when it has no uuid\n * @param byId - every annotation's fields by id, for an arrow's ends\n * @returns the annotations, or null for a kind not read\n */\nfunction readOne(\n    f: ReadonlyMap<string, string>,\n    index: string,\n    byId: ReadonlyMap<string, ReadonlyMap<string, string>>,\n): GraphAnnotation[] | null {\n    const type = (f.get(\"type\") ?? \"\").replace(TYPE_PREFIX, \"\");\n    const zoom = positive(f.get(\"zoom\")) ?? 1;\n    const base: AnnotationBase = {\n        id: f.get(\"uuid\") ?? index,\n        layer: f.get(\"canvas\") === \"background\" ? \"background\" : \"foreground\",\n        z: num(f.get(\"z\")) ?? 0,\n    };\n    switch (type) {\n        case \"ShapeAnnotation\":\n            return [shapeOf(f, base, zoom)];\n        case \"TextAnnotation\":\n            return [textOf(f, base, zoom, { x: num(f.get(\"x\")) ?? 0, y: -(num(f.get(\"y\")) ?? 0) }, \"top-left\")];\n        case \"BoundedTextAnnotation\": {\n            const shape = shapeOf(f, base, zoom);\n            return [shape, textOf(f, { ...base, id: `${base.id}:text` }, zoom, shape.center, \"center\")];\n        }\n        case \"ArrowAnnotation\":\n            return arrowOf(f, base, zoom, byId);\n        default:\n            return null;\n    }\n}\n\n/**\n * A shape annotation: `x`, `y` its top-left corner, y down; `width`, `height` and the outline at the saved zoom.\n * @param f - its fields\n * @param base - its id, layer and order\n * @param zoom - the zoom its sizes were saved at\n * @returns the shape\n */\nfunction shapeOf(f: ReadonlyMap<string, string>, base: AnnotationBase, zoom: number): ShapeAnnotation {\n    const x = num(f.get(\"x\")) ?? 0;\n    const y = num(f.get(\"y\")) ?? 0;\n    const width = (positive(f.get(\"width\")) ?? 0) / zoom;\n    const height = (positive(f.get(\"height\")) ?? 0) / zoom;\n    const fill = javaColor(f.get(\"fillColor\"));\n    const border = javaColor(f.get(\"edgeColor\")) ?? { color: \"#000000\", alpha: 1 };\n    return {\n        ...base,\n        kind: \"shape\",\n        center: { x: x + width / 2, y: -(y + height / 2) },\n        width,\n        height,\n        shape: SHAPES.get((f.get(\"shapeType\") ?? \"rectangle\").toLowerCase()) ?? \"rectangle\",\n        fill: fill?.color ?? null,\n        fillOpacity: fill === null ? 0 : fill.alpha * percent(f.get(\"fillOpacity\")),\n        borderColor: border.color,\n        borderOpacity: border.alpha * percent(f.get(\"edgeOpacity\")),\n        borderWidth: (num(f.get(\"edgeThickness\")) ?? 1) / zoom,\n    };\n}\n\n/**\n * A text annotation, or the text of a bounded one.\n * @param f - its fields\n * @param base - its id, layer and order\n * @param zoom - the zoom its font size was saved at\n * @param at - where it is placed\n * @param anchor - what `at` is\n * @returns the text\n */\nfunction textOf(\n    f: ReadonlyMap<string, string>,\n    base: AnnotationBase,\n    zoom: number,\n    at: AnnotationPoint,\n    anchor: TextAnnotation[\"anchor\"],\n): TextAnnotation {\n    // java.awt.Font styles: 1 bold, 2 italic, 3 both\n    const style = num(f.get(\"fontStyle\")) ?? 0;\n    const color = javaColor(f.get(\"color\")) ?? { color: \"#000000\", alpha: 1 };\n    return {\n        ...base,\n        kind: \"text\",\n        text: f.get(\"text\") ?? \"\",\n        at,\n        anchor,\n        fontSize: (positive(f.get(\"fontSize\")) ?? 12) / zoom,\n        fontFamily: f.get(\"fontFamily\") ?? \"sans-serif\",\n        bold: (style & 1) !== 0,\n        italic: (style & 2) !== 0,\n        color: color.color,\n        opacity: color.alpha,\n    };\n}\n\n/**\n * An arrow annotation. Cytoscape keeps its start as the annotation it leaves (`sourceAnnotation`) and its end as a\n * point, a node's center at save time (`targetNode`) or another annotation, and saves the arrow's top-left corner\n * as `x`, `y`: the start wherever the end lies right of and below it, which is taken for the start, else the center\n * of the annotation it leaves.\n * @param f - its fields\n * @param base - its id, layer and order\n * @param zoom - the zoom its line width was saved at\n * @param byId - every annotation's fields by id\n * @returns the arrow, or null when it has no end\n */\nfunction arrowOf(\n    f: ReadonlyMap<string, string>,\n    base: AnnotationBase,\n    zoom: number,\n    byId: ReadonlyMap<string, ReadonlyMap<string, string>>,\n): ArrowAnnotation[] | null {\n    const target = f.get(\"targetAnnotation\");\n    const to = point(f.get(\"targetPoint\")) ?? point(f.get(\"targetNode\")) ?? centerOf(byId.get(target ?? \"\"), zoom);\n    if (to === null) {\n        return null;\n    }\n    const corner = { x: num(f.get(\"x\")) ?? 0, y: num(f.get(\"y\")) ?? 0 };\n    const source = centerOf(byId.get(f.get(\"sourceAnnotation\") ?? \"\"), zoom) ?? corner;\n    // ponytail: the start is exact only when the end lies right of and below it; elsewhere the center of the\n    // annotation it leaves, as Cytoscape stores no other start. Clip to that annotation's box if it matters.\n    const from = { x: to.x > corner.x ? corner.x : source.x, y: to.y > corner.y ? corner.y : source.y };\n    const color = javaColor(f.get(\"lineColor\")) ?? { color: \"#000000\", alpha: 1 };\n    return [\n        {\n            ...base,\n            kind: \"arrow\",\n            from: { x: from.x, y: -from.y },\n            to: { x: to.x, y: -to.y },\n            color: color.color,\n            opacity: color.alpha * percent(f.get(\"lineOpacity\")),\n            width: (positive(f.get(\"lineThickness\")) ?? 1) / zoom,\n            sourceArrow: arrowShape(f.get(\"sourceType\")),\n            targetArrow: arrowShape(f.get(\"targetType\")),\n            sourceSize: positive(f.get(\"sourceSize\")) ?? 1,\n            targetSize: positive(f.get(\"targetSize\")) ?? 1,\n        },\n    ];\n}\n\n/**\n * An annotation's center, y down as the file writes it: a shape's box center, a text's corner.\n * @param f - its fields, or undefined\n * @param zoom - the zoom the arrow was saved at\n * @returns the point, or null\n */\nfunction centerOf(f: ReadonlyMap<string, string> | undefined, zoom: number): AnnotationPoint | null {\n    if (f === undefined) {\n        return null;\n    }\n    const x = num(f.get(\"x\"));\n    const y = num(f.get(\"y\"));\n    if (x === null || y === null) {\n        return null;\n    }\n    return { x: x + (positive(f.get(\"width\")) ?? 0) / zoom / 2, y: y + (positive(f.get(\"height\")) ?? 0) / zoom / 2 };\n}\n\n/**\n * An arrowhead by its `ArrowType` position or name.\n * @param raw - the field\n * @returns the shape; a triangle for one not known\n */\nfunction arrowShape(raw: string | undefined): StyleArrowShape {\n    if (raw === undefined) {\n        return \"none\";\n    }\n    const n = num(raw);\n    if (n !== null) {\n        return ARROW_ORDER[n] ?? \"triangle\";\n    }\n    return ARROW_NAMES.get(raw.trim().toLowerCase()) ?? \"triangle\";\n}\n\n/**\n * A `x,y` point as the file writes it.\n * @param raw - the field\n * @returns the point, or null\n */\nfunction point(raw: string | undefined): AnnotationPoint | null {\n    const [x, y] = (raw ?? \"\").split(\",\").map((s) => num(s));\n    return x === null || x === undefined || y === null || y === undefined ? null : { x, y };\n}\n\n/**\n * A Java color as a signed ARGB integer.\n * @param raw - the field\n * @returns the color and its alpha, or null\n */\nfunction javaColor(raw: string | undefined): { color: StyleColor; alpha: number } | null {\n    const n = num(raw);\n    if (n === null || !Number.isInteger(n)) {\n        return null;\n    }\n    const argb = n >>> 0;\n    return {\n        color: `#${(argb & 0xffffff).toString(16).padStart(6, \"0\")}`,\n        alpha: (argb >>> 24) / 255,\n    };\n}\n\n/**\n * A 0..100 percentage as 0..1; 1 when absent.\n * @param raw - the field\n * @returns the fraction\n */\nfunction percent(raw: string | undefined): number {\n    const n = num(raw);\n    return n === null ? 1 : Math.min(1, Math.max(0, n / 100));\n}\n\n/**\n * A finite number.\n * @param raw - the field\n * @returns the number, or null\n */\nfunction num(raw: string | undefined): number | null {\n    if (raw === undefined || raw.trim() === \"\") {\n        return null;\n    }\n    const n = Number(raw);\n    return Number.isFinite(n) ? n : null;\n}\n\n/**\n * A positive number.\n * @param raw - the field\n * @returns the number, or null\n */\nfunction positive(raw: string | undefined): number | null {\n    const n = num(raw);\n    return n !== null && n > 0 ? n : null;\n}\n","/**\n * The styles of a live Cytoscape.js core: the rules from its stylesheet (`cy.style().json()`) and, when given, the\n * truth per element from what the core reports it draws (`ele.style()`). Reported values win over the stylesheet\n * where they disagree, so a property whose stylesheet value is a function (which `cy.style().json()` writes as \"fn\")\n * is still exact: it is copied per element from the reported values and noted as `W_STYLE_LAYER_FLATTENED` with the\n * sample (and the rule reason) `FUNCTION`.\n */\n\nimport type { GraphSnapshot } from \"@graphty/graph-format\";\n\nimport { StyleBudget } from \"../budget.js\";\nimport { StyleNotes } from \"../notes.js\";\nimport { featuresOf, styleFingerprint } from \"../plan/features.js\";\nimport { planStyles } from \"../plan/plan.js\";\nimport type { ExtractedStyles, StyleWorkBudget } from \"../types.js\";\nimport { evaluateCytoscapeJs } from \"./cascade.js\";\n\n/** The input of `readCytoscapeStyles()`. */\nexport interface CytoscapeLiveInput {\n    /** The core's elements: `cy.elements().jsons()`, or `{ nodes, edges }`. */\n    readonly elements: unknown;\n    /** The core's stylesheet: `cy.style().json()` (a function is written there as \"fn\"), or the one it was given. */\n    readonly style: unknown;\n    /**\n     * What the core draws for each element, `ele.style()`, in the order of `elements` (for `{ nodes, edges }`, the\n     * nodes then the edges); optional, and null for an element with none.\n     */\n    readonly rendered?: readonly (Readonly<Record<string, unknown>> | null | undefined)[];\n    /** The graph the styles are for (the core's elements as a snapshot); the values come out indexed like it. */\n    readonly snapshot: GraphSnapshot;\n    /** The graph-io format id recorded as the styles' source; default \"json\". */\n    readonly format?: string;\n    /** Whether Cytoscape.js's defaults fill what the stylesheet leaves unset; default true. */\n    readonly toolDefaults?: boolean;\n    /**\n     * Where problems are noted; graph-io's own engine passes its notes here.\n     * @internal\n     */\n    readonly notes?: StyleNotes;\n    /** The counted work budget. */\n    readonly budget?: StyleWorkBudget;\n    /** Cancels the work. */\n    readonly signal?: AbortSignal;\n}\n\n/**\n * What a stylesheet function is read as: a function, whatever it returned.\n * @returns nothing\n */\nconst FUNCTION = (): null => null;\n\n/**\n * The stylesheet with every \"fn\" value (how `cy.style().json()` writes a function) read as a function.\n * @param style - the stylesheet\n * @returns the stylesheet to apply\n */\nfunction withFunctions(style: unknown): unknown {\n    if (!Array.isArray(style)) {\n        return style;\n    }\n    return style.map((entry: unknown) => {\n        if (entry === null || typeof entry !== \"object\") {\n            return entry;\n        }\n        const e = entry as Record<string, unknown>;\n        const props = e.style ?? e.css;\n        if (props === null || typeof props !== \"object\") {\n            return entry;\n        }\n        const copy = Object.create(null) as Record<string, unknown>;\n        for (const name of Object.keys(props)) {\n            const v = (props as Record<string, unknown>)[name];\n            copy[name] = v === \"fn\" ? FUNCTION : v;\n        }\n        return { selector: e.selector, style: copy };\n    });\n}\n\n/**\n * The element list in order: an array as it is, `{ nodes, edges }` as the nodes then the edges.\n * @param elements - the elements\n * @returns the list\n */\nfunction elementList(elements: unknown): readonly unknown[] {\n    if (Array.isArray(elements)) {\n        return elements;\n    }\n    if (elements !== null && typeof elements === \"object\") {\n        const e = elements as Record<string, unknown>;\n        return [...(Array.isArray(e.nodes) ? e.nodes : []), ...(Array.isArray(e.edges) ? e.edges : [])];\n    }\n    return [];\n}\n\n/**\n * Reads the styles of a live Cytoscape.js core: the stylesheet's rules, with what the core reports it draws as the\n * truth per element when given.\n * @param input - the elements, the stylesheet, the reported values and the graph\n * @returns the styles, exact for every element\n * @category Styles\n */\nexport function readCytoscapeStyles(input: CytoscapeLiveInput): ExtractedStyles {\n    const notes = input.notes ?? new StyleNotes();\n    const budget = input.budget ?? new StyleBudget();\n    let rendered: Map<object, Readonly<Record<string, unknown>>> | undefined;\n    if (input.rendered !== undefined) {\n        rendered = new Map();\n        const list = elementList(input.elements);\n        for (let i = 0; i < list.length && i < input.rendered.length; i++) {\n            const json = list[i];\n            const r = input.rendered[i];\n            if (json !== null && typeof json === \"object\" && r !== null && r !== undefined && typeof r === \"object\") {\n                rendered.set(json, r);\n            }\n        }\n    }\n    const r = evaluateCytoscapeJs({\n        elements: input.elements,\n        style: withFunctions(input.style),\n        snapshot: input.snapshot,\n        toolDefaults: input.toolDefaults,\n        rendered,\n        notes,\n        budget,\n        signal: input.signal,\n    });\n    const s = input.snapshot;\n    return planStyles(\n        {\n            format: input.format ?? \"json\",\n            dialect: \"cytoscape-js\",\n            tool: \"cytoscape-js\",\n            units: \"px\",\n            node: { values: r.node.values, rules: r.node.rules, columns: r.node.columns },\n            edge: { values: r.edge.values, rules: r.edge.rules, columns: r.edge.columns },\n            fingerprint: styleFingerprint(s),\n        },\n        { node: featuresOf(s, \"node\"), edge: featuresOf(s, \"edge\") },\n        {\n            toolDefaults: input.toolDefaults,\n            notes,\n            budget,\n            signal: input.signal,\n            rawColumns: { node: r.node.rawColumns, edge: r.edge.rawColumns },\n        },\n    );\n}\n"],"names":["e","r"],"mappings":"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"}
+{"version":3,"file":"styles.js","sources":["../src/styles/cyjs/live.ts","../src/styles/slots.ts"],"sourcesContent":["/**\n * The styles of a live Cytoscape.js core: the rules from its stylesheet (`cy.style().json()`) and, when given, the\n * truth per element from what the core reports it draws (`ele.style()`). Reported values win over the stylesheet\n * where they disagree, so a property whose stylesheet value is a function (which `cy.style().json()` writes as \"fn\")\n * is still exact: it is copied per element from the reported values and noted as `W_STYLE_LAYER_FLATTENED` with the\n * sample (and the rule reason) `FUNCTION`.\n */\n\nimport type { GraphSnapshot } from \"@graphty/graph-format\";\n\nimport { StyleBudget } from \"../budget.js\";\nimport { StyleNotes } from \"../notes.js\";\nimport { featuresOf, styleFingerprint } from \"../plan/features.js\";\nimport { planStyles } from \"../plan/plan.js\";\nimport type { ExtractedStyles, StyleWorkBudget } from \"../types.js\";\nimport { evaluateCytoscapeJs } from \"./cascade.js\";\n\n/** The input of `readCytoscapeStyles()`. */\nexport interface CytoscapeLiveInput {\n    /** The core's elements: `cy.elements().jsons()`, or `{ nodes, edges }`. */\n    readonly elements: unknown;\n    /** The core's stylesheet: `cy.style().json()` (a function is written there as \"fn\"), or the one it was given. */\n    readonly style: unknown;\n    /**\n     * What the core draws for each element, `ele.style()`, in the order of `elements` (for `{ nodes, edges }`, the\n     * nodes then the edges); optional, and null for an element with none.\n     */\n    readonly rendered?: readonly (Readonly<Record<string, unknown>> | null | undefined)[];\n    /** The graph the styles are for (the core's elements as a snapshot); the values come out indexed like it. */\n    readonly snapshot: GraphSnapshot;\n    /** The graph-io format id recorded as the styles' source; default \"json\". */\n    readonly format?: string;\n    /** Whether Cytoscape.js's defaults fill what the stylesheet leaves unset; default true. */\n    readonly toolDefaults?: boolean;\n    /**\n     * Where problems are noted; graph-io's own engine passes its notes here.\n     * @internal\n     */\n    readonly notes?: StyleNotes;\n    /** The counted work budget. */\n    readonly budget?: StyleWorkBudget;\n    /** Cancels the work. */\n    readonly signal?: AbortSignal;\n}\n\n/**\n * What a stylesheet function is read as: a function, whatever it returned.\n * @returns nothing\n */\nconst FUNCTION = (): null => null;\n\n/**\n * The stylesheet with every \"fn\" value (how `cy.style().json()` writes a function) read as a function.\n * @param style - the stylesheet\n * @returns the stylesheet to apply\n */\nfunction withFunctions(style: unknown): unknown {\n    if (!Array.isArray(style)) {\n        return style;\n    }\n    return style.map((entry: unknown) => {\n        if (entry === null || typeof entry !== \"object\") {\n            return entry;\n        }\n        const e = entry as Record<string, unknown>;\n        const props = e.style ?? e.css;\n        if (props === null || typeof props !== \"object\") {\n            return entry;\n        }\n        const copy = Object.create(null) as Record<string, unknown>;\n        for (const name of Object.keys(props)) {\n            const v = (props as Record<string, unknown>)[name];\n            copy[name] = v === \"fn\" ? FUNCTION : v;\n        }\n        return { selector: e.selector, style: copy };\n    });\n}\n\n/**\n * The element list in order: an array as it is, `{ nodes, edges }` as the nodes then the edges.\n * @param elements - the elements\n * @returns the list\n */\nfunction elementList(elements: unknown): readonly unknown[] {\n    if (Array.isArray(elements)) {\n        return elements;\n    }\n    if (elements !== null && typeof elements === \"object\") {\n        const e = elements as Record<string, unknown>;\n        return [...(Array.isArray(e.nodes) ? e.nodes : []), ...(Array.isArray(e.edges) ? e.edges : [])];\n    }\n    return [];\n}\n\n/**\n * Reads the styles of a live Cytoscape.js core: the stylesheet's rules, with what the core reports it draws as the\n * truth per element when given.\n * @param input - the elements, the stylesheet, the reported values and the graph\n * @returns the styles, exact for every element\n * @category Styles\n */\nexport function readCytoscapeStyles(input: CytoscapeLiveInput): ExtractedStyles {\n    const notes = input.notes ?? new StyleNotes();\n    const budget = input.budget ?? new StyleBudget();\n    let rendered: Map<object, Readonly<Record<string, unknown>>> | undefined;\n    if (input.rendered !== undefined) {\n        rendered = new Map();\n        const list = elementList(input.elements);\n        for (let i = 0; i < list.length && i < input.rendered.length; i++) {\n            const json = list[i];\n            const r = input.rendered[i];\n            if (json !== null && typeof json === \"object\" && r !== null && r !== undefined && typeof r === \"object\") {\n                rendered.set(json, r);\n            }\n        }\n    }\n    const r = evaluateCytoscapeJs({\n        elements: input.elements,\n        style: withFunctions(input.style),\n        snapshot: input.snapshot,\n        toolDefaults: input.toolDefaults,\n        rendered,\n        notes,\n        budget,\n        signal: input.signal,\n    });\n    const s = input.snapshot;\n    return planStyles(\n        {\n            format: input.format ?? \"json\",\n            dialect: \"cytoscape-js\",\n            tool: \"cytoscape-js\",\n            units: \"px\",\n            node: { values: r.node.values, rules: r.node.rules, columns: r.node.columns },\n            edge: { values: r.edge.values, rules: r.edge.rules, columns: r.edge.columns },\n            fingerprint: styleFingerprint(s),\n        },\n        { node: featuresOf(s, \"node\"), edge: featuresOf(s, \"edge\") },\n        {\n            toolDefaults: input.toolDefaults,\n            notes,\n            budget,\n            signal: input.signal,\n            rawColumns: { node: r.node.rawColumns, edge: r.edge.rawColumns },\n        },\n    );\n}\n","/**\n * Which imported columns hold a format's own style slots rather than data.\n */\n\nimport type { ColumnMeta } from \"@graphty/graph-format\";\n\n// spelled out here rather than imported, so the styles entry loads no format module\n/** The origin namespaces of the columns the CX and CX2 importers read a file's bypasses into. */\nconst BYPASS_NAMESPACES: ReadonlySet<string> = new Set([\"cx.bypass\", \"cx2.bypass\"]);\n\n/**\n * Whether an imported column holds the file's own style slots rather than data: the bypasses of a CX or CX2 file,\n * and the `<graphics>` block of an XGMML element (or a Cytoscape session's). An application that draws the file's\n * styles from `extractStyles()` leaves these columns off its records, since the styles carry them.\n * @param meta - the column's metadata\n * @returns true for a style slot\n * @category Styles\n */\nexport function isStyleSlotColumn(meta: ColumnMeta): boolean {\n    const { origin } = meta;\n    return (\n        (typeof origin?.namespace === \"string\" && BYPASS_NAMESPACES.has(origin.namespace)) ||\n        (meta.dtype === \"json\" && origin?.type === \"graphics\" && origin.namespace === \"xgmml\")\n    );\n}\n"],"names":["e","v","r"],"mappings":"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"}

package/dist/xgmml.js

@@ -1,6 +1,6 @@
-import { X, a } from "./chunks/styles-BQnsga7p.js";
-import { x } from "./chunks/exporter-DndFlGSa.js";
-import { x as x2 } from "./chunks/importer-yh_aBCU6.js";
+import { X, a } from "./chunks/styles-CCs214_3.js";
+import { x } from "./chunks/exporter-D9yMtocA.js";
+import { x as x2 } from "./chunks/importer-Vn5QvmmJ.js";
 export {
   X as XGMML_ISSUE,
   a as XGMML_LOSS,

package/docs/samples/people.json

@@ -0,0 +1,6 @@
+[
+    { "id": "ana", "name": "Ana", "knows": ["bo", "cy"] },
+    { "id": "bo", "name": "Bo", "knows": ["cy"] },
+    { "id": "cy", "name": "Cy", "knows": [] },
+    { "id": "di", "name": "Di", "knows": ["ana", "eve"] }
+]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphty/graph-io",
-  "version": "0.3.47",
+  "version": "0.3.49",
   "description": "Read and write 13 graph file formats (JSON, GraphML, GEXF, CSV, GML, DOT, Pajek, Neo4j CSV, XGMML, CX2, CX, OBO, Cytoscape sessions) as @graphty/graph-format snapshots",
   "author": "Adam Powers <apowers@ato.ms>",
   "type": "module",
@@ -77,6 +77,26 @@
       "import": "./dist/cys.js",
       "default": "./dist/cys.js"
     },
+    "./sources/ndex": {
+      "types": "./dist/sources-ndex.d.ts",
+      "import": "./dist/sources-ndex.js",
+      "default": "./dist/sources-ndex.js"
+    },
+    "./sources/cypher": {
+      "types": "./dist/sources-cypher.d.ts",
+      "import": "./dist/sources-cypher.js",
+      "default": "./dist/sources-cypher.js"
+    },
+    "./sources/rest": {
+      "types": "./dist/sources-rest.d.ts",
+      "import": "./dist/sources-rest.js",
+      "default": "./dist/sources-rest.js"
+    },
+    "./sources/sparql": {
+      "types": "./dist/sources-sparql.d.ts",
+      "import": "./dist/sources-sparql.js",
+      "default": "./dist/sources-sparql.js"
+    },
     "./styles": {
       "types": "./dist/styles.d.ts",
       "import": "./dist/styles.js",
@@ -131,41 +151,66 @@
   },
   "homepage": "https://graphty.app/docs/graph-io/",
   "dependencies": {
-    "@graphty/graph-format": "^1.4.6"
+    "@graphty/graph-format": "^1.4.8"
   },
   "peerDependencies": {
-    "@graphty/graph-format": "^1.0.0"
+    "@graphty/graph-format": "^1.0.0",
+    "neo4j-driver": "^5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "neo4j-driver": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@resvg/resvg-js": "2.6.2",
+    "@sigma/export-image": "4.0.0",
+    "@storybook/addon-vitest": "^9.1.21",
+    "@storybook/web-components-vite": "^9.0.11",
+    "@vitest/browser-playwright": "4.1.11",
     "@vitest/coverage-v8": "4.1.11",
     "@vitest/ui": "4.1.11",
-    "cytoscape": "^3.34.3",
+    "cytoscape": "3.34.3",
+    "esbuild": "0.25.10",
     "eslint": "^9.29.0",
     "fast-check": "^4.2.0",
     "fast-xml-parser": "^5.11.1",
+    "graphology": "0.26.0",
+    "lit": "^3.3.1",
+    "neo4j-driver": "^5.28.3",
+    "playwright": "^1.53.0",
     "prettier": "^3.4.2",
+    "sigma": "4.0.1",
+    "storybook": "^9.1.21",
+    "svgcanvas": "2.6.0",
     "tsx": "^4.20.3",
     "typedoc": "^0.28.15",
     "typescript": "^5.9.3",
-    "vite": "^7.0.5",
+    "vis-data": "7.1.9",
+    "vis-network": "9.1.9",
+    "vite": "^7.3.7",
     "vitest": "4.1.11"
   },
   "scripts": {
     "build": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json",
     "build:bundle": "node scripts/build-bundle.js",
     "build:all": "npm run build && npm run build:bundle",
-    "lint": "eslint && tsc --noEmit -p tsconfig.json",
+    "lint": "eslint && tsc --noEmit -p tsconfig.json && tsc --noEmit -p fidelity-stories/tsconfig.json",
     "lint:fix": "eslint --fix",
-    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p fidelity-stories/tsconfig.json",
     "typecheck:strict-consumer": "tsc -p tsconfig.strict-consumer.json",
     "test": "vitest",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",
+    "test:storybook": "vitest run --config vitest.storybook.config.ts",
     "coverage": "vitest run --coverage",
     "coverage:preview": "npx serve coverage -p ${PORT:?start it through servherd, which sets PORT}",
     "benchmark": "tsx benchmarks/run.ts",
     "docs:reference": "tsx scripts/docs-reference.ts",
     "docs:api": "tsx scripts/docs-reference.ts --check && typedoc && node ../tools/sanitize-api-docs.js docs/api/generated",
-    "ready:commit": "npm run build:all && npm run lint && npm run typecheck:strict-consumer && npm run test:run"
+    "ready:commit": "npm run build:all && npm run lint && npm run typecheck:strict-consumer && npm run test:run",
+    "test:browser": "vitest run --config vitest.browser.config.ts",
+    "storybook": "storybook dev -c fidelity-stories/.storybook -p ${PORT:?start it through servherd, which sets PORT} --host ${HOST:-localhost} ${HTTPS_CERT_PATH:+--https --ssl-cert $HTTPS_CERT_PATH --ssl-key $HTTPS_KEY_PATH} --no-open",
+    "build-storybook": "git lfs pull --include \"graph-io/test/fidelity/oracles/*.png\" && storybook build -c fidelity-stories/.storybook -o fidelity-stories/storybook-static"
   }
 }

package/src/common/report.ts

@@ -198,10 +198,17 @@ export class ImportReportBuilder {
      * @param code - a stable code such as "E_UNKNOWN_NODE"
      * @param message - a plain-ASCII message
      * @param where - the line and element, when known
+     * @param params - the issue's machine-readable values (`{ status: 401 }`), when it has any
      * @returns the recorded issue
      */
-    error(category: IssueCategory, code: string, message: string, where?: IssueLocation): ImportIssue {
-        const issue = makeIssue(category, "error", code, message, where);
+    error(
+        category: IssueCategory,
+        code: string,
+        message: string,
+        where?: IssueLocation,
+        params?: Readonly<Record<string, unknown>>,
+    ): ImportIssue {
+        const issue = makeIssue(category, "error", code, message, where, params);
         this.issueList.push(issue);
         this.errors++;
         if (this.errors > this.errorLimit) {
@@ -222,10 +229,17 @@ export class ImportReportBuilder {
      * @param code - a stable code such as "W_WIDENED"
      * @param message - a plain-ASCII message
      * @param where - the line and element, when known
+     * @param params - the issue's machine-readable values, when it has any
      * @returns the recorded issue
      */
-    warning(category: IssueCategory, code: string, message: string, where?: IssueLocation): ImportIssue {
-        const issue = makeIssue(category, "warning", code, message, where);
+    warning(
+        category: IssueCategory,
+        code: string,
+        message: string,
+        where?: IssueLocation,
+        params?: Readonly<Record<string, unknown>>,
+    ): ImportIssue {
+        const issue = makeIssue(category, "warning", code, message, where, params);
         const seen = (this.warningsByCode.get(code) ?? 0) + 1;
         this.warningsByCode.set(code, seen);
         if (seen <= MAX_WARNINGS_PER_CODE) {
@@ -365,6 +379,7 @@ export class ImportReportBuilder {
      * @param message - a plain-ASCII message
      * @param where - the line and element, when known
      * @param details - optional machine-readable context for the ImportError
+     * @param params - the issue's machine-readable values, when it has any
      */
     failWith(
         category: IssueCategory,
@@ -372,8 +387,9 @@ export class ImportReportBuilder {
         message: string,
         where?: IssueLocation,
         details?: Readonly<Record<string, unknown>>,
+        params?: Readonly<Record<string, unknown>>,
     ): never {
-        this.issueList.push(makeIssue(category, "error", code, message, where));
+        this.issueList.push(makeIssue(category, "error", code, message, where, params));
         this.errors++;
         throw this.abort(withLine(message, where), { code, ...details });
     }
@@ -463,6 +479,7 @@ export class ImportReportBuilder {
  * @param code - the stable code
  * @param message - the message
  * @param where - the location, when known
+ * @param params - the issue's values, when it has any
  * @returns the issue
  */
 function makeIssue(
@@ -471,15 +488,18 @@ function makeIssue(
     code: string,
     message: string,
     where: IssueLocation | undefined,
+    params?: Readonly<Record<string, unknown>>,
 ): ImportIssue {
-    return Object.freeze({
+    const issue = {
         category,
         severity,
         code,
         message,
         line: where?.line ?? null,
         element: where?.element ?? null,
-    });
+    };
+    // the key only when there are values, so the issues of every format keep their shape
+    return Object.freeze(params === undefined ? issue : { ...issue, params: Object.freeze({ ...params }) });
 }
 
 /**

package/src/formats/cx/importer.ts

@@ -2936,7 +2936,12 @@ class CxReader {
                 }
                 return true;
             });
-        const source: CxStyleSource = others.size > 0 ? { entries: kept, otherViews: others.size } : { entries: kept };
+        const { weightFrom } = this.options;
+        const collection = aspect(this.doc, "cySubNetworks").length > 0;
+        const source: CxStyleSource =
+            others.size > 0
+                ? { entries: kept, otherViews: others.size, weightFrom, collection }
+                : { entries: kept, weightFrom, collection };
         this.report.keepForStyles(source);
     }