@graphty/layout 1.2.6 → 1.2.7

package/README.md

@@ -4,9 +4,9 @@
 [![Coverage Status](https://coveralls.io/repos/github/graphty-org/layout/badge.svg?branch=main)](https://coveralls.io/github/graphty-org/layout?branch=main)
 [![npm version](https://badge.fury.io/js/%40graphty%2Flayout.svg)](https://badge.fury.io/js/%40graphty%2Flayout)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![GitHub Pages](https://img.shields.io/badge/demo-github%20pages-blue)](https://graphty-org.github.io/layout/)
+[![GitHub Pages](https://img.shields.io/badge/demo-github%20pages-blue)](https://graphty-org.github.io/layout/examples/index.html)
 
-**[View Interactive Examples →](https://graphty-org.github.io/layout/index.html)**
+**[View Interactive Examples →](https://graphty-org.github.io/layout/examples/index.html)**
 
 Layout is a TypeScript library for positioning nodes in graphs. It's a TypeScript port of the [layout algorithms](https://networkx.org/documentation/stable/reference/drawing.html) from the Python [NetworkX](https://networkx.org/documentation/stable/) library.
 
@@ -51,6 +51,12 @@ Additionally, the library includes:
 - **combineLayouts** - Blend multiple layout algorithms
 - **interpolateLayouts** - Smooth animation between layouts
 
+## Installation
+
+```bash
+npm install @graphty/layout
+```
+
 ## How to Use
 
 Import the library in your TypeScript/JavaScript project:
@@ -91,7 +97,7 @@ import {
   layoutQuality,
   combineLayouts,
   interpolateLayouts
-} from './layout.js'
+} from '@graphty/layout'
 ```
 
 ## Quick Start
@@ -476,12 +482,30 @@ if (detected) {
 }
 ```
 
+## 3D Support
+
+All layout algorithms support 3D positioning by setting the `dim` parameter to 3:
+
+```typescript
+// Any layout algorithm in 3D
+const positions3D = springLayout(graph, null, null, null, 50, 1, [0, 0, 0], 3)
+// Returns: { node1: [x, y, z], node2: [x, y, z], ... }
+
+// ForceAtlas2 in 3D
+const fa3D = forceatlas2Layout(graph, null, 100, 1, 2, 1, false, false, null, null, null, false, false, 42, 3)
+
+// Circular layout in 3D (creates a sphere)
+const circular3D = circularLayout(graph, 1, [0, 0, 0], 3)
+```
+
+When using 3D layouts, positions will have three coordinates `[x, y, z]` instead of two.
+
 ## Common Parameters
 
 Most layout functions share these parameters:
 
 - **scale** (number): Scale factor for positions (default: 1)
-- **center** (number[]): Center coordinates around which to center the layout (default: [0, 0])
+- **center** (number[]): Center coordinates around which to center the layout (default: [0, 0] for 2D, [0, 0, 0] for 3D)
 - **dim** (number): Layout dimension - 2D or 3D (default: 2)
 - **seed** (number): Seed for random generation (for reproducible layouts)
 
@@ -722,7 +746,26 @@ const positions = forceatlas2Layout(
   true, // dissuadeHubs: good for scale-free
   false, // linlog: logarithmic attraction
   42, // seed
-  2 // dim
+  2 // dim: 2 for 2D, 3 for 3D
+)
+
+// 3D layout example
+const positions3D = forceatlas2Layout(
+  graph,
+  null,
+  100,
+  1.0,
+  2.0,
+  1.0,
+  false,
+  false,
+  null,
+  null,
+  null,
+  false,
+  false,
+  42,
+  3 // 3D mode - returns [x, y, z] coordinates
 )
 ```
 
@@ -1098,6 +1141,13 @@ To deploy to GitHub Pages, see `gh-pages/DEPLOY.md` after building.
 4. **Build for production** with `npm run build:all`
 5. **Deploy examples** with `npm run build:gh-pages`
 
+## Recent Updates
+
+### Version 1.2.7 (Latest)
+- **Fixed**: ForceAtlas2 now correctly returns numeric Z coordinates in 3D mode (previously returned NaN)
+- **Fixed**: NPM package now uses the correct bundled entry point (`dist/layout.js`)
+- **Added**: Full 3D support documentation and examples
+
 ## Contributing
 
 This project is a TypeScript port of the NetworkX Python library. For contributions and issues, visit the [GitHub repository](https://github.com/graphty-org/layout).

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@graphty/layout",
-  "version": "1.2.6",
+  "version": "1.2.7",
   "description": "graph layout algorithms based on networkx",
   "author": "Adam Powers <apowers@ato.ms>",
-  "main": "dist/src/index.js",
+  "main": "dist/layout.js",
   "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/src/index.js",
+      "import": "./dist/layout.js",
       "types": "./dist/src/index.d.ts"
     }
   },