npm - @graphty/layout - Versions diffs - 1.1.0 → 1.2.0 - Mend

@graphty/layout 1.1.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (57) hide show

package/.env.example +11 -0
package/.github/workflows/ci.yml +89 -14
package/.releaserc.json +22 -0
package/CHANGELOG.md +31 -0
package/CLAUDE.md +104 -0
package/CONTRIBUTING.md +1 -0
package/DEPLOYMENT.md +59 -0
package/README.md +662 -93
package/dist/layout-helpers.d.ts +123 -0
package/dist/layout-helpers.js +458 -0
package/dist/layout-helpers.js.map +1 -0
package/dist/layout.d.ts +275 -0
package/dist/layout.js +2304 -0
package/dist/layout.js.map +1 -0
package/dist/vitest.config.d.ts +2 -0
package/dist/vitest.config.js +30 -0
package/dist/vitest.config.js.map +1 -0
package/examples/3d-force-directed.html +611 -0
package/examples/3d-kamada-kawai.html +394 -0
package/examples/3d-layout-comparison.html +448 -0
package/examples/3d-spherical-layout.html +319 -0
package/examples/arf-layout.html +13 -1
package/examples/bfs-layout.html +49 -39
package/examples/bipartite-layout.html +89 -69
package/examples/circular-layout.html +26 -35
package/examples/forceatlas2-layout.html +134 -28
package/examples/index.html +75 -0
package/examples/kamada-kawai-layout.html +13 -1
package/examples/multipartite-layout.html +73 -88
package/examples/planar-layout.html +13 -1
package/examples/random-layout.html +13 -1
package/examples/shell-layout.html +65 -34
package/examples/spectral-layout.html +13 -1
package/examples/spiral-layout.html +13 -1
package/examples/spring-layout.html +25 -3
package/layout-helpers.ts +560 -0
package/layout.ts +316 -14
package/package.json +20 -6
package/test/arf-layout.test.ts +443 -0
package/test/bfs-layout.test.ts +427 -0
package/test/bipartite-layout.test.ts +344 -0
package/test/circular-layout.test.ts +442 -0
package/test/forceatlas2-layout.test.ts +405 -0
package/test/fruchterman-reingold-layout.test.ts +477 -0
package/test/graph-generators.test.ts +450 -0
package/test/kamada-kawai-layout.test.ts +623 -0
package/test/multipartite-layout.test.ts +404 -0
package/test/planar-layout.test.ts +266 -0
package/test/random-layout.test.ts +254 -0
package/test/rescale-layout.test.ts +373 -0
package/test/shell-layout.test.ts +347 -0
package/test/spectral-layout.test.ts +378 -0
package/test/spiral-layout.test.ts +338 -0
package/test/spring-layout.test.ts +241 -0
package/vite.config.js +36 -0
package/vitest.config.ts +30 -0
package/.releaserc +0 -3

package/examples/3d-spherical-layout.html ADDED Viewed

@@ -0,0 +1,319 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <!-- Eruda Mobile Console -->
+  <script src="https://cdn.jsdelivr.net/npm/eruda@3/eruda.min.js"></script>
+  <script>
+    // Initialize Eruda console for mobile debugging
+    if (typeof eruda !== "undefined") {
+      eruda.init();
+      // Auto-show on mobile devices
+      if (/mobile|android|ios|iphone|ipad|ipod/i.test(navigator.userAgent.toLowerCase())) {
+        eruda.show();
+      }
+    }
+  </script>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>3D Spherical Layout - @graphty/layout</title>
+  <style>
+    body {
+      margin: 0;
+      font-family: Arial, sans-serif;
+      overflow: hidden;
+    }
+    #container {
+      width: 100vw;
+      height: 100vh;
+    }
+    #info {
+      position: absolute;
+      top: 10px;
+      left: 10px;
+      color: white;
+      background: rgba(0, 0, 0, 0.7);
+      padding: 10px;
+      border-radius: 5px;
+    }
+    #controls {
+      position: absolute;
+      top: 10px;
+      right: 10px;
+      background: rgba(0, 0, 0, 0.7);
+      padding: 10px;
+      border-radius: 5px;
+      color: white;
+    }
+    button {
+      display: block;
+      margin: 5px 0;
+      padding: 5px 10px;
+      cursor: pointer;
+    }
+    label {
+      display: block;
+      margin: 5px 0;
+    }
+  </style>
+</head>
+<body>
+  <div id="container"></div>
+  <div id="info">
+    <h2>3D Spherical Layout</h2>
+    <p>Nodes distributed evenly on a sphere using Fibonacci spiral</p>
+    <p>Drag to rotate • Scroll to zoom</p>
+  </div>
+  <div id="controls">
+    <label>
+      Graph Type:
+      <select id="graphType">
+        <option value="complete">Complete Graph</option>
+        <option value="cycle">Cycle Graph</option>
+        <option value="star">Star Graph</option>
+        <option value="wheel">Wheel Graph</option>
+        <option value="grid">Grid Graph</option>
+        <option value="random">Random Graph</option>
+      </select>
+    </label>
+    <label>
+      Node Count: <span id="nodeCountLabel">20</span>
+      <input type="range" id="nodeCount" min="5" max="50" value="20">
+    </label>
+    <label>
+      Sphere Radius: <span id="radiusLabel">200</span>
+      <input type="range" id="radius" min="50" max="300" value="200">
+    </label>
+    <button id="regenerate">Regenerate Graph</button>
+    <label>
+      <input type="checkbox" id="showSphere" checked> Show Sphere
+    </label>
+    <label>
+      <input type="checkbox" id="animateRotation" checked> Auto Rotate
+    </label>
+  </div>
+  <!-- Import map for module resolution -->
+  <script type="importmap">
+    {
+      "imports": {
+        "three": "https://unpkg.com/three@0.157.0/build/three.module.js",
+        "three/addons/": "https://unpkg.com/three@0.157.0/examples/jsm/"
+      }
+    }
+  </script>
+  <script type="module">
+    import * as THREE from 'https://unpkg.com/three@0.157.0/build/three.module.js';
+    import { OrbitControls } from 'https://unpkg.com/three@0.157.0/examples/jsm/controls/OrbitControls.js';
+    import {
+      circularLayout,
+      completeGraph,
+      cycleGraph,
+      starGraph,
+      wheelGraph,
+      gridGraph,
+      randomGraph
+    } from './layout.js';
+    // Three.js setup
+    const scene = new THREE.Scene();
+    scene.background = new THREE.Color(0x0a0a0a);
+    const camera = new THREE.PerspectiveCamera(
+      75,
+      window.innerWidth / window.innerHeight,
+      0.1,
+      2000
+    );
+    camera.position.set(400, 300, 500);
+    const renderer = new THREE.WebGLRenderer({ antialias: true });
+    renderer.setSize(window.innerWidth, window.innerHeight);
+    document.getElementById('container').appendChild(renderer.domElement);
+    const controls = new OrbitControls(camera, renderer.domElement);
+    controls.enableDamping = true;
+    controls.dampingFactor = 0.05;
+    // Lighting
+    const ambientLight = new THREE.AmbientLight(0xffffff, 0.6);
+    scene.add(ambientLight);
+    const directionalLight = new THREE.DirectionalLight(0xffffff, 0.4);
+    directionalLight.position.set(1, 1, 1);
+    scene.add(directionalLight);
+    // Graph visualization
+    let nodeGroup = new THREE.Group();
+    let edgeGroup = new THREE.Group();
+    let sphereMesh = null;
+    scene.add(nodeGroup);
+    scene.add(edgeGroup);
+    // Create sphere mesh
+    function createSphereMesh(radius) {
+      const geometry = new THREE.SphereGeometry(radius, 32, 32);
+      const material = new THREE.MeshBasicMaterial({
+        color: 0x444444,
+        wireframe: true,
+        transparent: true,
+        opacity: 0.2
+      });
+      return new THREE.Mesh(geometry, material);
+    }
+    // Create graph based on type
+    function createGraph(type, nodeCount) {
+      switch (type) {
+        case 'complete':
+          return completeGraph(nodeCount);
+        case 'cycle':
+          return cycleGraph(nodeCount);
+        case 'star':
+          return starGraph(nodeCount);
+        case 'wheel':
+          return wheelGraph(nodeCount);
+        case 'grid':
+          const size = Math.floor(Math.sqrt(nodeCount));
+          return gridGraph(size, size);
+        case 'random':
+          return randomGraph(nodeCount, 0.3, Date.now());
+        default:
+          return completeGraph(nodeCount);
+      }
+    }
+    // Visualize graph in 3D
+    function visualizeGraph(graph, radius) {
+      // Clear previous visualization
+      nodeGroup.clear();
+      edgeGroup.clear();
+      // Get 3D spherical layout
+      const positions = circularLayout(graph, radius, [0, 0, 0], 3);
+      // Create nodes
+      const nodeGeometry = new THREE.SphereGeometry(8, 16, 16);
+      const nodes = graph.nodes();
+      const nodeMeshes = {};
+      nodes.forEach((node, i) => {
+        const color = new THREE.Color();
+        color.setHSL(i / nodes.length, 0.7, 0.5);
+        const material = new THREE.MeshPhongMaterial({
+          color: color,
+          emissive: color,
+          emissiveIntensity: 0.3
+        });
+        const mesh = new THREE.Mesh(nodeGeometry, material);
+        const [x, y, z] = positions[node];
+        mesh.position.set(x, y, z);
+        nodeGroup.add(mesh);
+        nodeMeshes[node] = mesh;
+      });
+      // Create edges
+      const edges = graph.edges();
+      edges.forEach(([source, target]) => {
+        const sourcePos = positions[source];
+        const targetPos = positions[target];
+        const points = [
+          new THREE.Vector3(sourcePos[0], sourcePos[1], sourcePos[2]),
+          new THREE.Vector3(targetPos[0], targetPos[1], targetPos[2])
+        ];
+        const geometry = new THREE.BufferGeometry().setFromPoints(points);
+        const material = new THREE.LineBasicMaterial({
+          color: 0x4444ff,
+          transparent: true,
+          opacity: 0.6
+        });
+        const line = new THREE.Line(geometry, material);
+        edgeGroup.add(line);
+      });
+    }
+    // Initial graph
+    let currentGraph = createGraph('complete', 20);
+    visualizeGraph(currentGraph, 200);
+    // Add sphere
+    sphereMesh = createSphereMesh(200);
+    scene.add(sphereMesh);
+    // Controls
+    const graphTypeSelect = document.getElementById('graphType');
+    const nodeCountSlider = document.getElementById('nodeCount');
+    const nodeCountLabel = document.getElementById('nodeCountLabel');
+    const radiusSlider = document.getElementById('radius');
+    const radiusLabel = document.getElementById('radiusLabel');
+    const regenerateBtn = document.getElementById('regenerate');
+    const showSphereCheckbox = document.getElementById('showSphere');
+    const animateCheckbox = document.getElementById('animateRotation');
+    nodeCountSlider.addEventListener('input', (e) => {
+      nodeCountLabel.textContent = e.target.value;
+    });
+    radiusSlider.addEventListener('input', (e) => {
+      radiusLabel.textContent = e.target.value;
+      const radius = parseInt(e.target.value);
+      visualizeGraph(currentGraph, radius);
+      if (sphereMesh) {
+        scene.remove(sphereMesh);
+        sphereMesh = createSphereMesh(radius);
+        sphereMesh.visible = showSphereCheckbox.checked;
+        scene.add(sphereMesh);
+      }
+    });
+    regenerateBtn.addEventListener('click', () => {
+      const type = graphTypeSelect.value;
+      const nodeCount = parseInt(nodeCountSlider.value);
+      const radius = parseInt(radiusSlider.value);
+      currentGraph = createGraph(type, nodeCount);
+      visualizeGraph(currentGraph, radius);
+    });
+    graphTypeSelect.addEventListener('change', () => {
+      regenerateBtn.click();
+    });
+    showSphereCheckbox.addEventListener('change', (e) => {
+      if (sphereMesh) {
+        sphereMesh.visible = e.target.checked;
+      }
+    });
+    // Animation
+    function animate() {
+      requestAnimationFrame(animate);
+      if (animateCheckbox.checked) {
+        nodeGroup.rotation.y += 0.002;
+        edgeGroup.rotation.y += 0.002;
+        if (sphereMesh) {
+          sphereMesh.rotation.y += 0.002;
+        }
+      }
+      controls.update();
+      renderer.render(scene, camera);
+    }
+    // Handle window resize
+    window.addEventListener('resize', () => {
+      camera.aspect = window.innerWidth / window.innerHeight;
+      camera.updateProjectionMatrix();
+      renderer.setSize(window.innerWidth, window.innerHeight);
+    });
+    animate();
+  </script>
+</body>
+</html>

package/examples/arf-layout.html CHANGED Viewed

@@ -1,6 +1,18 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
+  <!-- Eruda Mobile Console -->
+  <script src="https://cdn.jsdelivr.net/npm/eruda@3/eruda.min.js"></script>
+  <script>
+    // Initialize Eruda console for mobile debugging
+    if (typeof eruda !== "undefined") {
+      eruda.init();
+      // Auto-show on mobile devices
+      if (/mobile|android|ios|iphone|ipad|ipod/i.test(navigator.userAgent.toLowerCase())) {
+        eruda.show();
+      }
+    }
+  </script>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>ARF Layout Test</title>
@@ -178,7 +190,7 @@
     </div>
     <script type="module">
-        import { arfLayout } from '../dist/layout.js';
+        import { arfLayout } from "./layout.js";
         let currentGraph = null;
         let currentSeed = Math.floor(Math.random() * 1000);

package/examples/bfs-layout.html CHANGED Viewed

@@ -1,6 +1,18 @@
 <!DOCTYPE html>
 <html lang="en">
 <head>
+  <!-- Eruda Mobile Console -->
+  <script src="https://cdn.jsdelivr.net/npm/eruda@3/eruda.min.js"></script>
+  <script>
+    // Initialize Eruda console for mobile debugging
+    if (typeof eruda !== "undefined") {
+      eruda.init();
+      // Auto-show on mobile devices
+      if (/mobile|android|ios|iphone|ipad|ipod/i.test(navigator.userAgent.toLowerCase())) {
+        eruda.show();
+      }
+    }
+  </script>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>BFS Layout Test</title>
@@ -129,6 +141,14 @@
             <h3>Layout Parameters</h3>
             <div class="control-group">
+                <label for="root-selection">Root selection:</label>
+                <select id="root-selection">
+                    <option value="auto">Auto (best root)</option>
+                    <option value="manual">Manual selection</option>
+                </select>
+            </div>
+            <div class="control-group" id="manual-node-group">
                 <label for="start-node">Starting node:</label>
                 <select id="start-node">
                     <!-- Dynamically populated -->
@@ -149,55 +169,38 @@
     </div>
     <script type="module">
-        import { bfsLayout } from '../dist/layout.js';
+        import {
+            bfsLayout,
+            starGraph,
+            gridGraph,
+            randomGraph,
+            scaleFreeGraph,
+            findBestRoot
+        } from "./layout.js";
         let currentGraph = null;
+        let bestRoot = null;
         function generateGraph(type, numNodes) {
-            const nodes = Array.from({length: numNodes}, (_, i) => i);
-            const edges = [];
             switch(type) {
                 case 'tree':
-                    // Generate a connected tree
-                    for (let i = 1; i < numNodes; i++) {
-                        const parent = Math.floor(Math.random() * i);
-                        edges.push([parent, i]);
-                    }
-                    break;
+                    // Generate tree-like structure using scale-free with low m
+                    return scaleFreeGraph(numNodes, 1, Date.now());
                 case 'connected':
-                    // First create a tree to ensure connectivity
-                    for (let i = 1; i < numNodes; i++) {
-                        const parent = Math.floor(Math.random() * i);
-                        edges.push([parent, i]);
-                    }
-                    // Add some extra edges
-                    const extraEdges = Math.floor(numNodes * 0.3);
-                    for (let i = 0; i < extraEdges; i++) {
-                        const a = Math.floor(Math.random() * numNodes);
-                        const b = Math.floor(Math.random() * numNodes);
-                        if (a !== b && !edges.some(([s, t]) =>
-                            (s === a && t === b) || (s === b && t === a))) {
-                            edges.push([a, b]);
-                        }
-                    }
-                    break;
+                    // Generate connected random graph
+                    return randomGraph(numNodes, 0.15, Date.now());
                 case 'grid':
-                    // Create an approximate grid
-                    const gridSize = Math.ceil(Math.sqrt(numNodes));
-                    for (let i = 0; i < numNodes; i++) {
-                        const row = Math.floor(i / gridSize);
-                        const col = i % gridSize;
-                        // Connect to the right
-                        if (col < gridSize - 1 && i + 1 < numNodes) {
-                            edges.push([i, i + 1]);
-                        }
-                        // Connect below
-                        if (row < gridSize - 1 && i + gridSize < numNodes) {
+                    // Create grid
+                    const size = Math.ceil(Math.sqrt(numNodes));
+                    return gridGraph(size, size);
+                case 'star':
+                    return starGraph(numNodes);
+                default:
+                    return randomGraph(numNodes, 0.2, Date.now());
                             edges.push([i, i + gridSize]);
                         }
                     }
@@ -471,6 +474,13 @@
                 };
             });
+            // Root selection handler
+            document.getElementById('root-selection').onchange = function() {
+                const manualGroup = document.getElementById('manual-node-group');
+                manualGroup.style.opacity = this.value === 'auto' ? '0.5' : '1';
+                manualGroup.style.pointerEvents = this.value === 'auto' ? 'none' : 'auto';
+            };
             document.getElementById('graph-type').onchange = null;
             document.getElementById('start-node').onchange = null;
             document.getElementById('alignment').onchange = null;