@fusion.dev/helix-graph 0.139.0 → 0.140.0

package/dist/connect-graph/connect-graph.js

@@ -1,4 +1,4 @@
-import { HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, isRtl, watchTheme, } from '@fusion.dev/helix-core';
+import { HelixGraphPanEvent, HelixGraphPartChangeEvent, HelixGraphSignalEvent, HelixGraphZoomEvent, isRtl, reportRuntime, watchTheme, } from '@fusion.dev/helix-core';
 import { arrangeByGroup, hubsOf } from './arrange.js';
 import { diffGraph, isEmpty, linkKey, } from './diff.js';
 import { graphColorsFrom, looksOf, toneColor, } from './looks.js';
@@ -18,7 +18,12 @@ const still = () => typeof matchMedia === 'function' && matchMedia('(prefers-red
 export const connectGraph = (frame, driver, options = {}) => {
     const graph = frame;
     if (!('nodes' in frame) || typeof graph.requestActive !== 'function') {
-        console.warn('connectGraph: the element given is not a Graph frame (helix-graph or helix-headless-graph), so nothing will be drawn.', frame);
+        reportRuntime({
+            detail: frame,
+            kind: 'not-a-graph',
+            message: 'connectGraph: the element given is not a Graph frame (helix-graph or helix-headless-graph), so nothing will be drawn.',
+            tag: frame.localName,
+        });
     }
     let known = new Map();
     let framed;
@@ -154,7 +159,12 @@ export const connectGraph = (frame, driver, options = {}) => {
             shapeFrame = fit.frame;
         }
         else if (shaping) {
-            console.warn('connectGraph: the stencil has no inside to place the notes in, so the graph is laid out instead.', options.stencil);
+            reportRuntime({
+                detail: options.stencil,
+                kind: 'stencil-without-inside',
+                message: 'connectGraph: the stencil has no inside to place the notes in, so the graph is laid out instead.',
+                tag: frame.localName,
+            });
             positions = seedPositions(nodes.map(({ id }) => ({ id })), linkList, new Map()).positions;
             unplaced = new Set(ids);
         }

package/dist/connect-graph/stencil.js

@@ -1,3 +1,4 @@
+import { reportRuntime } from '@fusion.dev/helix-core';
 import { fieldFromInside, fieldFromPath } from '../shapes/shape-field.js';
 import { surfaceWeb } from './surface-web.js';
 const PROBE = { flat: 64, solid: 32 };
@@ -181,12 +182,18 @@ export const fitInStencil = (positions, stencil, { clustersOf, } = {}) => {
         ? placesByRegion(field, asked, options)
         : undefined;
     if (regional && regional.missing.length > 0) {
-        console.warn(`fitInStencil: the shape has no part named ${regional.missing.map((part) => `"${part}"`).join(', ')}, so the notes sent there are placed with the rest. Its parts: ${[...regional.found].join(', ') || 'none'}.`);
+        reportRuntime({
+            kind: 'missing-stencil-parts',
+            message: `fitInStencil: the shape has no part named ${regional.missing.map((part) => `"${part}"`).join(', ')}, so the notes sent there are placed with the rest. Its parts: ${[...regional.found].join(', ') || 'none'}.`,
+        });
     }
     else if (!regional && [...asked.keys()].some((region) => region !== undefined)) {
-        console.warn(field.regionOf
-            ? 'fitInStencil: the parts named in regions are too small for the notes sent to them, so the notes are placed over the whole shape.'
-            : 'fitInStencil: the shape has no named parts, so regions is not used and the notes are placed over the whole shape.');
+        reportRuntime({
+            kind: 'stencil-regions-unused',
+            message: field.regionOf
+                ? 'fitInStencil: the parts named in regions are too small for the notes sent to them, so the notes are placed over the whole shape.'
+                : 'fitInStencil: the shape has no named parts, so regions is not used and the notes are placed over the whole shape.',
+        });
     }
     for (const [id, region] of noteRegion) {
         if (region !== undefined && !regional?.found.has(region)) {

package/dist/three/three-driver.js

@@ -1,3 +1,4 @@
+import { reportRuntime } from '@fusion.dev/helix-core';
 import { AdditiveBlending, BoxGeometry, BufferAttribute, BufferGeometry, DoubleSide, Euler, InstancedBufferAttribute, InstancedMesh, Matrix4, Mesh, NormalBlending, OctahedronGeometry, PerspectiveCamera, Points, Quaternion, Raycaster, Scene, ShaderMaterial, TOUCH, Vector2, Vector3, WebGLRenderer, } from 'three';
 import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
 import { LineMaterial } from 'three/addons/lines/LineMaterial.js';
@@ -1319,7 +1320,12 @@ export const threeDriver = (container, options = {}) => {
                 wake();
             })
                 .catch((cause) => {
-                console.error(new Error('The three.js driver could not load d3-force-3d to lay out the notes. Install d3-force-3d alongside @fusion.dev/helix-graph.', { cause }));
+                reportRuntime({
+                    detail: cause,
+                    kind: 'missing-layout',
+                    level: 'error',
+                    message: 'The three.js driver could not load d3-force-3d to lay out the notes. Install d3-force-3d alongside @fusion.dev/helix-graph.',
+                });
                 if (!done && !stopped) {
                     done = true;
                     placed(new Map(nodes.map((node) => [node.id, { x: node.x, y: node.y, z: node.z }])));

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fusion.dev/helix-graph",
   "description": "Connects the Helix Graph frame to a graph renderer: Sigma.js, cosmos.gl, three.js, or a driver of your own.",
-  "version": "0.139.0",
+  "version": "0.140.0",
   "license": "MIT",
   "author": "Ross Sheppard <ross.sheppard@fusion.dev>",
   "repository": {
@@ -55,12 +55,12 @@
   },
   "bugs": "https://github.com/project-fusion/fusion/issues",
   "dependencies": {
-    "@fusion.dev/helix-core": "0.139.0"
+    "@fusion.dev/helix-core": "0.140.0"
   },
   "devDependencies": {
     "@cosmos.gl/graph": "^3.4.2",
-    "@fusion.dev/helix-headless": "0.139.0",
-    "@fusion.dev/helix-testing": "0.139.0",
+    "@fusion.dev/helix-headless": "0.140.0",
+    "@fusion.dev/helix-testing": "0.140.0",
     "@types/bun": "^1.3.0",
     "@types/three": "^0.186.0",
     "d3-force-3d": "^3.0.6",