Feat/sigma renderer

.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+# Cancel superseded runs on the same ref to save runner minutes.
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Unit tests
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Run tests
+        run: npm test
+
+  perf:
+    name: Renderer perf gates
+    runs-on: ubuntu-latest
+    # Timing/FPS gates can be noisy on shared runners, so this job reports but
+    # does not block merges. Treat a failure here as a signal to investigate.
+    continue-on-error: true
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run perf benchmark (acceptance gates)
+        run: node scripts/perf_benchmark.js --assert

.gitignore

@@ -7,10 +7,16 @@
 node_modules/
 dist/
 
+# Coverage reports (npm run test:coverage)
+coverage/
+
 # Generated bundle (rebuilt during dist/build)
 src/gll.bundle.js
 src/gll.bundle.js.map
 
+# Perf benchmark artifacts (regenerate via npm run perf:fixture / npm run perf)
+scripts/fixtures/
+
 # Compiled Java class files
 *.class
 

.prettierignore

@@ -0,0 +1,22 @@
+# Dependencies & environments
+node_modules/
+.venv/
+
+# Build output & generated artifacts
+dist/
+coverage/
+src/lib/
+src/gll.bundle.js
+src/gll.bundle.js.map
+src/**/*_prompt.js
+scripts/fixtures/
+
+# Lockfiles
+package-lock.json
+uv.lock
+
+# Research manuscript (kept as-is)
+manuscript/
+
+# Minified vendor files
+*.min.js

.prettierrc.json

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

API.md

@@ -196,26 +196,38 @@ An edge is an object. `source` and `target` are required and must match node
 | `id`          | string | `"<source>::<target>"` | Explicit edge id. Auto-generated if omitted.              |
 | `label`       | string | —                      | Display text along the edge.                              |
 | `description` | string | —                      | Tooltip text.                                             |
-| `type`        | string | `"line"`               | `line` (straight); also `cubic`, `quadratic`, `polyline`. |
+| `type`        | string | `"line"`               | `line` (straight); also `cubic`, `quadratic`, `polyline`. **Note:** since the Sigma renderer, `polyline` renders as a curve (same as `cubic`/`quadratic`). |
 | `style`       | object | —                      | Visual styling — see below.                               |
 | `D4Data`      | object | —                      | Data attributes that define filters — see §6.             |
 
-### `edge.style` — line, arrows, halo
+### `edge.style` — line, arrows, halo, flow
 
 | Path             | Type    | Default       | Meaning                                              |
 | ---------------- | ------- | ------------- | ---------------------------------------------------- |
 | `stroke`         | hex     | `"#403C5390"` | Line colour (last 2 hex digits = alpha).             |
 | `lineWidth`      | number  | `0.75`        | Line thickness (px).                                 |
-| `lineDash`       | number  | `0`           | Dash length; `0` = solid, e.g. `10` = dashed.        |
-| `startArrow`     | boolean | `false`       | Arrowhead at the source end.                         |
-| `startArrowType` | string  | `"triangle"`  | `triangle`/`circle`/`diamond`/`vee`/`rect`/`simple`. |
-| `startArrowSize` | number  | `8`           | Source arrowhead size.                               |
-| `endArrow`       | boolean | `false`       | Arrowhead at the target end.                         |
-| `endArrowType`   | string  | `"triangle"`  | Same enum as `startArrowType`.                       |
-| `endArrowSize`   | number  | `8`           | Target arrowhead size.                               |
-| `halo`           | boolean | `false`       | Glow behind the edge.                                |
+| `lineDash`       | number  | `0`           | Dash length. **Note:** kept in the data model and round-trips through export, but the Sigma renderer draws all edges solid (dashes are not rendered in v1). |
+| `startArrow`     | boolean | `false`       | End marker at the source end.                        |
+| `startArrowType` | string  | `"arrow"`     | `arrow`/`rect`/`diamond`/`circle`/`tee` (⊣ inhibition bar). Legacy G6 names still load and round-trip unchanged (`triangle`/`vee`/`simple` → arrow, `triangleRect`/`square` → rect). |
+| `startArrowSize` | number  | `8`           | Source marker length (graph px). Unset/0 → sized proportionally to the line width. |
+| `startArrowColor`       | hex    | `null` | Source marker fill. `null` → inherits the edge stroke colour. |
+| `startArrowBorderColor` | hex    | `null` | Source marker border colour. `null` → no border (transparent). |
+| `startArrowBorderSize`  | number | `0`    | Source marker border thickness (px). `0` → auto (~20% of the marker). |
+| `endArrow`       | boolean | `false`       | End marker at the target end.                        |
+| `endArrowType`   | string  | `"arrow"`     | Same enum as `startArrowType`.                       |
+| `endArrowSize`   | number  | `8`           | Target marker length (graph px).                     |
+| `endArrowColor`       | hex    | `null` | Target marker fill. `null` → inherits the edge stroke colour. |
+| `endArrowBorderColor` | hex    | `null` | Target marker border colour. `null` → no border (transparent). |
+| `endArrowBorderSize`  | number | `0`    | Target marker border thickness (px). `0` → auto (~20% of the marker). |
+| `halo`           | boolean | `false`       | Glow drawn under the edge (total width = line + 2 × `haloLineWidth`), on straight and curved edges. Selecting an edge widens line and halo together. |
 | `haloStroke`     | hex     | `"#403C53"`   | Halo colour.                                         |
 | `haloLineWidth`  | number  | `3`           | Halo thickness (px).                                 |
+| `flow`           | boolean | `false`       | Enable the animated source→target flow overlay.      |
+| `flowType`       | string  | `"dash"`      | `dash` / `pulse` / `comet` / `chevron`.              |
+| `flowSpeed`      | number  | `1`           | Animation speed multiplier.                          |
+| `flowStroke`     | hex     | `null`        | Flow colour. `null` → derived from the edge stroke (lightened). |
+| `flowOpacity`    | number  | `1`           | Multiplies into the overlay colour's alpha (0–1).    |
+| `flowDensity`    | number  | `1`           | Scales the pattern period (higher = sparser dashes/dots). |
 
 Edge labels use the same `label*` fields as nodes (§4), with edge-specific
 defaults: `labelPlacement` defaults to `"center"` (`start`/`center`/`end`),