@kortexya/nodus 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kortexya/nodus",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Nodus \u2014 a high-performance graph visualization engine (WebGL/WebGPU/Canvas/SVG).",
   "homepage": "https://kortexya.com",
   "author": "Kortexya <david.loiret@kortexya.com>",
@@ -19,7 +19,10 @@
     "clean:dist": "rm -f nodus.src.bundle.js nodus_wasm-*.js nodus_render_wasm-*.js __vite-plugin-wasm-helper-*.js chunk-*.js && rm -rf assets types",
     "build:types": "tsc -p tsconfig.json --declaration --emitDeclarationOnly --noEmit false --outDir types",
     "prepublishOnly": "npm run build",
-    "release": "bash scripts/release.sh"
+    "release": "bash scripts/release.sh",
+    "docs:dev": "npm --prefix docs run dev",
+    "docs:build": "npm --prefix docs run build",
+    "docs:preview": "npm --prefix docs run preview"
   },
   "exports": {
     ".": {

package/types/renderers/WasmGraphRenderer.d.ts

@@ -25,16 +25,24 @@ export declare class WasmGraphRenderer {
     private _raf;
     private _toLinear;
     private _styleVersion;
+    private _styleDirty;
+    private _frameScheduled;
     private _radii;
     private _fill;
     private _shape;
     private _stroke;
     private _sw;
+    private _swMinVis;
+    private _layer;
+    private _pulses;
     private _outline;
     private _haloCol;
     private _haloW;
+    private _outerCol;
+    private _outerW;
     private _imageTile;
     private _atlasKey;
+    private _pieColors;
     private _pieOffset;
     private _pieCount;
     private _pieSegs;
@@ -42,14 +50,45 @@ export declare class WasmGraphRenderer {
     private _edgeColor;
     private _edgeWidth;
     private _edgeCurv;
+    private _edgeArrows;
+    private _edgeDash;
+    private _edgeHaloCol;
+    private _edgeHaloW;
+    private _edgeOutlineCol;
+    private _edgeOutlineW;
+    private _edgeLabel;
+    private _edgeLabelFont;
+    private _edgeLabelCol;
+    private _edgeLabelSize;
+    private _edgeLabelSec;
+    private _edgeLabelSecFont;
+    private _edgeLabelSecCol;
     private _xs;
     private _ys;
     private _nodeIds;
     private _labels;
     private _lastCam;
-    private _fitted;
+    private _autoFrame;
+    private _selfMovingCamera;
+    private _lastFit;
     private _glyphs;
+    private _glyphKey;
+    private _textFonts;
+    private _labelCol;
+    private _labelMinVis;
+    private _labelMaxLine;
+    private _labelSize;
+    private _labelSecSize;
+    private _labelPos;
+    private _labelSecondary;
+    private _labelSecCol;
+    private _labelSecFont;
+    private _labelSecBg;
+    private _labelBgCol;
+    private _icons;
     private _fontPx;
+    private _targetAtlasPx;
+    private _quadScale;
     private _highlight;
     private _pieData;
     private _badgeNode;
@@ -60,13 +99,19 @@ export declare class WasmGraphRenderer {
     private _badgeStrokeCol;
     private _badgeStrokeW;
     private _badgeText;
+    private _badgeFont;
     private _badgeTextCol;
     private constructor();
+    /** Coalesce redraw requests into a single rAF-driven frame (no-op if one is already pending or the
+     * environment has no rAF). Keeps event-driven redraws cheap when many events fire in one tick. */
+    private _scheduleFrame;
     /** Create a renderer bound to `canvas`. `WasmRendererClass` is the lazy-loaded wgpu class. */
     static create(nodus: any, canvas: HTMLCanvasElement, WasmRendererClass: any, opts?: WasmGraphRendererOptions): Promise<WasmGraphRenderer>;
     /** Rasterise an ASCII glyph atlas (white, alpha=coverage) into a texture the TEXT shader samples,
      * recording each glyph's UV region. Monospace-ish layout in a fixed cell grid. */
     private _buildAtlas;
+    /** CELL/ATLAS_PX from `_buildAtlas` — scales a quad so the em renders at the requested font size. */
+    private static readonly _QUAD_SCALE;
     /** Load image URLs into a 16×16 tile grid atlas (64px tiles, 1024² sRGB) and upload it; redraw on
      * completion so node icons appear. attrEx.y (set in _buildNodeAttrs) selects each node's tile. */
     private _loadAtlas;
@@ -76,6 +121,11 @@ export declare class WasmGraphRenderer {
     private _buildText;
     private _dpr;
     private _sizeCanvas;
+    /** Keep the backing store (and wgpu surface) matched to the canvas's displayed CSS size × DPR.
+     * Called every frame — a no-op when the size is unchanged. Without it a responsive container or a
+     * canvas sized before layout (clientWidth 0 → 320 fallback at create) renders at a stale, smaller
+     * resolution that the browser upscales, which reads as a soft / non-crisp image. */
+    private _syncCanvasSize;
     /** getAttribute that returns null instead of throwing on an undefined attribute name. */
     private _safeAttr;
     /** A Nodus style value (false/null = off, colour string, or {color,...}) → LINEAR rgba, or null. */
@@ -98,8 +148,16 @@ export declare class WasmGraphRenderer {
      *   [20..24] outerStrokeCol   [24..28] outlineCol */
     private _buildNodeAttrs;
     /** Assemble the edge attr SoA the EDGE shader decodes — 2×u32 per edge: packed rgba8 colour, then
-     * (widthU16 | dash<<16 | arrows<<20 | widthScale<<22 | curvByte<<24). The edge feature surface. */
+     * (width14 | dash<<14 | headShape<<16 | tailShape<<19 | widthScale<<22 | curvByte<<24). headShape/
+     * tailShape are 3-bit extremity shapes (0 none,1 arrow,2 square,3 circle,4 open-arrow). Feature surface. */
     private _buildEdgeAttrs;
+    /** Halo edges: a wider, halo-coloured copy of each haloed edge, packed like _buildEdgeAttrs so it can
+     * be PREPENDED (drawn behind the real edges). No dash/arrows; width = edgeWidth + 2·haloWidth. */
+    private _buildEdgeHalos;
+    /** Active pulse rings this frame → instance arrays (a transparent disk with a coloured inner-stroke
+     * ring). Each enabled node spawns a ring every `iv` ms; a ring lives `du` ms, growing sr→er·radius
+     * while its colour lerps sc→ec (→ transparent). Empty when nothing pulses. */
+    private _buildPulseRings;
     /** Draw one frame from the live graph. */
     renderFrame(): void;
     /** Hit-test a canvas-relative screen point (CSS px) → node id, or null. CPU point-in-radius