@graphty/layout 1.1.1 → 1.2.1

package/.env.example

@@ -0,0 +1,11 @@
+# Development Server Configuration
+# Copy this file to .env and adjust values as needed
+
+# Server host (defaults to true for network exposure)
+# HOST=localhost
+# HOST=0.0.0.0
+# HOST=my.server.com
+
+# Server port (defaults to 3000)
+# PORT=3000
+# PORT=8080

package/.github/workflows/ci.yml

@@ -38,16 +38,12 @@ jobs:
         run: npm run test:coverage
         if: matrix.node-version == '20.x'
         
-      - name: Upload coverage reports to Codecov
-        uses: codecov/codecov-action@v4
+      - name: Upload coverage reports to Coveralls
+        uses: coverallsapp/github-action@v2
         if: matrix.node-version == '20.x'
         with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
           file: ./coverage/lcov.info
-          flags: unittests
-          name: codecov-umbrella
-          fail_ci_if_error: false
-        env:
-          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
 
   lint:
     name: Lint

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [1.2.1](https://github.com/graphty-org/layout/compare/v1.2.0...v1.2.1) (2025-07-13)
+
+
+### Bug Fixes
+
+* resolve import errors and browser hang in shell layout example ([d65e436](https://github.com/graphty-org/layout/commit/d65e4360d9c42c885731ec952ea52978da61c7d5))
+
+# [1.2.0](https://github.com/graphty-org/layout/compare/v1.1.1...v1.2.0) (2025-07-12)
+
+
+### Features
+
+* add 3D examples and enhance development setup ([dbcb911](https://github.com/graphty-org/layout/commit/dbcb9117f77243c0c105c3bcf29252f0cf5d5484))
+
 ## [1.1.1](https://github.com/graphty-org/layout/compare/v1.1.0...v1.1.1) (2025-07-12)
 
 

package/DEPLOYMENT.md

@@ -0,0 +1,59 @@
+# Deployment Guide
+
+## GitHub Pages Setup
+
+This project uses a dual-build system to support both local development and GitHub Pages deployment.
+
+### For GitHub Pages Deployment:
+
+1. **Build the examples**:
+   ```bash
+   npm run build:examples
+   ```
+   This compiles TypeScript and copies `layout.js` to the `examples/` folder.
+
+2. **Commit the built files**:
+   ```bash
+   git add examples/layout.js
+   git commit -m "Update examples with latest layout.js"
+   git push
+   ```
+
+3. **GitHub Pages will serve** the examples directly from the `examples/` folder.
+
+### Local Development:
+
+- **For development**: `npm run serve` or `npm run examples`
+- **For testing**: Use any of the individual npm scripts
+- **File watching**: `npm run dev` or `npm run watch`
+
+### File Structure:
+
+```
+layout/
+├── layout.ts              # Source TypeScript
+├── dist/
+│   └── layout.js          # Compiled for npm package
+├── examples/
+│   ├── layout.js          # Copy for GitHub Pages
+│   ├── index.html         # Example index
+│   ├── 3d-force-directed.html
+│   └── ...other examples
+└── package.json
+```
+
+### Notes:
+
+- `examples/layout.js` is auto-generated and should not be edited directly
+- The file is ignored in `.gitignore` for local development
+- For GitHub Pages, you must commit this file manually before deployment
+- All examples use `import ... from './layout.js'` for maximum compatibility
+
+### GitHub Actions (Optional):
+
+For automated deployment, you could add a GitHub Action that:
+1. Runs `npm run build:examples`
+2. Commits the updated `examples/layout.js`
+3. Deploys to GitHub Pages
+
+This ensures the examples are always in sync with the latest TypeScript source.

package/README.md

@@ -1,7 +1,7 @@
 # Layout
 
 [![CI](https://github.com/graphty-org/layout/actions/workflows/ci.yml/badge.svg)](https://github.com/graphty-org/layout/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/graphty-org/layout/branch/main/graph/badge.svg)](https://codecov.io/gh/graphty-org/layout)
+[![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)
 
@@ -857,6 +857,59 @@ If you want to build the TypeScript module from source:
    
    This will watch for changes and automatically recompile the TypeScript files.
 
+## Development Server
+
+The project includes a Vite development server for testing and viewing examples.
+
+### Starting the Development Server
+
+```bash
+npm run serve
+```
+
+This will:
+- Start a development server on port 3000
+- Automatically open your browser to `/examples/`
+- Provide hot module reloading for development
+
+### Configuring the Development Server
+
+You can customize the server configuration using environment variables:
+
+1. **Create a `.env` file** (copy from `.env.example`):
+   ```bash
+   cp .env.example .env
+   ```
+
+2. **Configure server options in `.env`:**
+   ```bash
+   # Server host (defaults to true for network exposure)
+   HOST=localhost    # For local-only access
+   HOST=0.0.0.0     # For network access
+   HOST=my.server.com # For custom domain
+   
+   # Server port (defaults to 3000)
+   PORT=3000
+   PORT=8080        # Custom port
+   ```
+
+3. **Start the server with your configuration:**
+   ```bash
+   npm run serve
+   ```
+
+### Alternative: Build and Serve
+
+To build the project and then serve the examples:
+
+```bash
+npm run examples
+```
+
+This command:
+1. Builds the TypeScript files to JavaScript
+2. Starts the Vite development server
+
 **Note:** The compiled JavaScript files will be available in the `dist/` directory. You can import from the compiled JavaScript files or directly use the TypeScript source files in a TypeScript project.
 
 ## Implementation

package/dist/vitest.config.js

@@ -7,8 +7,8 @@ export default defineConfig({
         testTimeout: 30000,
         coverage: {
             provider: 'v8',
-            reporter: ['text', 'json', 'html'],
-            include: ['layout.ts'],
+            reporter: ['text', 'json', 'html', 'lcov'],
+            include: ['src/**/*.ts'],
             exclude: ['**/*.d.ts', '**/*.test.ts'],
             all: true,
             thresholds: {

package/dist/vitest.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAClC,OAAO,EAAE,CAAC,WAAW,CAAC;YACtB,OAAO,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;YACtC,GAAG,EAAE,IAAI;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACf;SACF;QACD,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,SAAS,EAAE,CAAC,SAAS,CAAC;KACvB;IACD,OAAO,EAAE;QACP,KAAK,EAAE;YACL,GAAG,EAAE,MAAM;SACZ;KACF;CACF,CAAC,CAAC"}
+{"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,WAAW;QACxB,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE;YACR,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC1C,OAAO,EAAE,CAAC,aAAa,CAAC;YACxB,OAAO,EAAE,CAAC,WAAW,EAAE,cAAc,CAAC;YACtC,GAAG,EAAE,IAAI;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,UAAU,EAAE,EAAE;aACf;SACF;QACD,OAAO,EAAE,CAAC,mBAAmB,CAAC;QAC9B,SAAS,EAAE,CAAC,SAAS,CAAC;KACvB;IACD,OAAO,EAAE;QACP,KAAK,EAAE;YACL,GAAG,EAAE,MAAM;SACZ;KACF;CACF,CAAC,CAAC"}