Hover glow: static (no pulse), fade-in/out transition, flush with disc edge

- The glow no longer pulses: it's a static halo (9px beyond the disc,
  0.45 alpha at the edge fading outward) in the node's state color.
- Hover enter/leave now cross-fades over ~180ms instead of appearing
  instantly: entering schedules sigma renders so drawHover repaints at
  the interpolated fade; leaving draws through a repainter captured on
  the last hover paint (sigma stops calling drawHover once unhovered).
  The text cross-fades too — the brighter hover name is drawn at
  partial alpha over the muted resting label on the layer beneath.
- The halo starts flush at the node disc edge (was size+1, leaving a
  dark gap ring that read as a gray border between node and glow).
- Both fade directions cancel each other and stop on completion, so
  there is no continuous loop — idle CPU stays near zero.
This commit is contained in:
amosblomqvist
2026-09-02 02:22:18 +03:00
parent aa14351474
commit 0a8c360546
+93 -51
View File
@@ -5,20 +5,22 @@
*
* sigma.js v3 + graphology + forceAtlas2, run-then-freeze: ONE synchronous
* forceAtlas2.assign (100 iterations, inferSettings) inside a useEffect
* writes x/y. No layout animation ever starts; the ONLY animation loop
* is the hover glow pulse, which runs strictly while a node is hovered
* and stops on leave — idle CPU stays near zero. Physics is placement
* only: pan/zoom, no dragging, no editing.
* writes x/y. No layout animation ever starts; the ONLY animation is the
* short hover fade (enter/leave transitions), strictly bounded in time
* and cancelled on unmount — idle CPU stays near zero. Physics is
* placement only: pan/zoom, no dragging, no editing.
*
* Labels render the node `name` (the short header, never the statement)
* through custom canvas drawers that replace sigma's defaults:
* - defaultDrawNodeLabel: plain wrapped text, centered below the node,
* word-wrapped at a max line width — no truncation, no one-line sprawl.
* - defaultDrawNodeHover: NO background box (sigma's default is a
* hardcoded white one). Instead the hovered node pulses a soft glow
* halo in its own state color and its name brightens — the "this is
* clickable, click for the full fact" affordance. Hover always shows
* the name, even when labels are zoomed out.
* hardcoded white one). Instead the hovered node gets a STATIC soft
* glow halo in its own state color, flush with the disc edge, and
* its name brightens — the "this is clickable, click for the full
* fact" affordance. Entering/leaving hover cross-fades (glow and text
* together) over a short transition; the glow itself never pulses.
* Hover always shows the name, even when labels are zoomed out.
* Labels are zoom-gated GLOBALLY with a fade: all names appear at once
* when the camera is at fit zoom or closer (ratio <= 1), then fade out
* together across a short zoom span before label rendering switches off —
@@ -71,14 +73,13 @@ const LABELS_CAMERA_RATIO = 1;
/** Zoom span (camera-ratio units) over which labels fade out together. */
const LABELS_FADE_SPAN = 0.5;
// Hover glow: a soft halo ring (never over the node disc), pulsing in the
// node's own color. The phase comes from performance.now() inside the
// drawer, so the effect only has to keep scheduling renders while hovered.
const GLOW_PAD_MIN = 4; // px beyond the node disc at the pulse's dimmest
const GLOW_PAD_SWING = 6; // extra px at the pulse's peak
const GLOW_ALPHA_MIN = 0.18;
const GLOW_ALPHA_SWING = 0.3;
const GLOW_PULSE_MS = 1600; // one full pulse cycle
// Hover glow: a STATIC soft halo ring in the node's own color, starting
// flush at the disc edge (no gap — a gap reads as a false outline/border
// between node and glow). The hovered/unhovered transition cross-fades
// glow + text over a short window; the glow never pulses.
const GLOW_PAD = 9; // px the halo extends beyond the node disc
const GLOW_ALPHA = 0.45; // halo opacity at the disc edge, fading outward
const HOVER_FADE_MS = 180; // hover enter/leave transition length
/** "#rrggbb" + alpha → "rgba(...)" (tokenHex only ever emits #rrggbb). */
function rgbaFromHex(hex: string, alpha: number): string {
@@ -138,31 +139,62 @@ function drawName(
context.restore();
}
/** Make the pair of canvas label drawers bound to the theme's colors. */
function makeLabelDrawers(labelColor: string, hoverTextColor: string) {
const drawLabel: NodeLabelDrawingFunction = (context, data, settings) => {
drawName(context, data, settings, labelColor);
};
const drawHover: NodeHoverDrawingFunction = (context, data, settings) => {
context.save();
// Pulsing glow halo in the node's own state color: a radial-gradient
// ring (the evenodd punch-out keeps the node disc itself untouched).
const pulse = 0.5 + 0.5 * Math.sin((performance.now() / GLOW_PULSE_MS) * Math.PI * 2);
const inner = data.size + 1;
const outer = data.size + GLOW_PAD_MIN + pulse * GLOW_PAD_SWING;
const alpha = GLOW_ALPHA_MIN + pulse * GLOW_ALPHA_SWING;
/** The hovered-state paint at a given transition factor (0 = resting,
* 1 = fully hovered): a static glow halo in the node's own state color
* starting flush at the disc edge (the evenodd punch-out keeps the disc
* itself unpainted), plus the name at partial alpha — the muted label on
* the layer beneath shows through, so the text cross-fades toward the
* brighter hover color as the glow blooms. */
function paintHover(
context: CanvasRenderingContext2D,
data: { label?: string | null; x: number; y: number; size: number; color: string },
settings: { labelSize: number; labelWeight: string; labelFont: string },
fade: number,
hoverTextColor: string,
): void {
context.save();
if (fade > 0.02) {
const inner = data.size;
const outer = data.size + GLOW_PAD * fade;
const glow = context.createRadialGradient(data.x, data.y, inner, data.x, data.y, outer);
glow.addColorStop(0, rgbaFromHex(data.color, alpha));
glow.addColorStop(0, rgbaFromHex(data.color, GLOW_ALPHA * fade));
glow.addColorStop(1, rgbaFromHex(data.color, 0));
context.fillStyle = glow;
context.beginPath();
context.arc(data.x, data.y, outer, 0, Math.PI * 2);
context.arc(data.x, data.y, inner, 0, Math.PI * 2, true);
context.fill("evenodd");
// Brighter name, no background box — the clickable affordance.
drawName(context, data, settings, hoverTextColor);
context.restore();
}
context.globalAlpha = fade;
drawName(context, data, settings, hoverTextColor);
context.restore();
}
/** Mutable hover-transition state shared between the drawers and the
* effect's enter/leave animation. */
interface HoverState {
fade: number;
/** Set on every sigma-driven hover paint; the leave animation draws
* through it directly, since sigma stops calling drawHover once the
* mouse has left the node. */
repaint: ((fade: number) => void) | null;
}
/** Make the pair of canvas label drawers bound to the theme's colors. */
function makeLabelDrawers(labelColor: string, hoverTextColor: string, hover: HoverState) {
const drawLabel: NodeLabelDrawingFunction = (context, data, settings) => {
drawName(context, data, settings, labelColor);
};
const drawHover: NodeHoverDrawingFunction = (context, data, settings) => {
hover.repaint = (fade) => {
context.save();
context.setTransform(1, 0, 0, 1, 0, 0);
context.clearRect(0, 0, context.canvas.width, context.canvas.height);
context.restore();
if (fade > 0) paintHover(context, data, settings, fade, hoverTextColor);
};
paintHover(context, data, settings, hover.fade, hoverTextColor);
};
return { drawLabel, drawHover };
@@ -233,7 +265,9 @@ export function GraphView() {
for (const state of Object.keys(STATE_TOKENS) as NodeStateClass[]) {
stateColors.set(state, tokenHex(STATE_TOKENS[state].cssVar));
}
const { drawLabel, drawHover } = makeLabelDrawers(labelColor, hoverTextColor);
// Mutable hover-transition state: 0 = resting, 1 = fully hovered.
const hover: HoverState = { fade: 0, repaint: null };
const { drawLabel, drawHover } = makeLabelDrawers(labelColor, hoverTextColor, hover);
const graph = new Graph();
for (const node of snapshot.nodes) {
@@ -268,7 +302,7 @@ export function GraphView() {
let killed = false;
let renderer: import("sigma").default | null = null;
// rAF id of the hover glow pulse (the ONLY animation loop — see the
// rAF id of the hover fade transition — the ONLY animation (see the
// file header). Lives out here so the effect cleanup can cancel it.
let hoverAnimId: number | null = null;
void import("sigma").then(({ default: Sigma }) => {
@@ -324,26 +358,34 @@ export function GraphView() {
syncRenderLabels(state.ratio);
setSelected(null);
});
// The hover glow is a slow pulse driven by performance.now() inside
// drawHover; this loop just keeps scheduling renders while a node is
// hovered and stops on leave, so idle CPU returns to zero.
const startHoverPulse = () => {
if (hoverAnimId !== null) return;
const tick = () => {
renderer?.scheduleRefresh();
hoverAnimId = requestAnimationFrame(tick);
};
hoverAnimId = requestAnimationFrame(tick);
};
const stopHoverPulse = () => {
// The hover fade: entering schedules renders (sigma re-invokes
// drawHover with the new fade); leaving draws through the captured
// repainter, since sigma stops calling drawHover once unhovered.
// Both directions are bounded (~HOVER_FADE_MS) and cancel each
// other, so idle CPU returns to zero after every transition.
const animateHoverTo = (target: number) => {
if (hoverAnimId !== null) {
cancelAnimationFrame(hoverAnimId);
hoverAnimId = null;
}
const from = hover.fade;
if (from === target) {
if (target === 0) hover.repaint?.(0);
return;
}
const start = performance.now();
const tick = (now: number) => {
const t = Math.min((now - start) / HOVER_FADE_MS, 1);
hover.fade = from + (target - from) * t;
if (target === 0) hover.repaint?.(hover.fade);
else renderer?.scheduleRefresh();
hoverAnimId = t < 1 ? requestAnimationFrame(tick) : null;
};
hoverAnimId = requestAnimationFrame(tick);
};
renderer.on("enterNode", startHoverPulse);
renderer.on("leaveNode", stopHoverPulse);
renderer.on("leaveStage", stopHoverPulse);
renderer.on("enterNode", () => animateHoverTo(1));
renderer.on("leaveNode", () => animateHoverTo(0));
renderer.on("leaveStage", () => animateHoverTo(0));
});
return () => {