Graph-Native Infrastructure for Context and Accountable AI Systems
Python agent-memoryaiai-governanceai-infrastructureartificial-intelligencecontext-engineeringcontext-graphsdata-engineeringdecision-intelligencedeveloper-toolsexplainable-aigenerative-aigraph-ragknowledge-graphllmontologyprovenancepythonreasoningsemantic-search
feat(explorer): polish graph explorer visual language
Zohaib Hassnain379994867dbf
diff --git a/explorer/src/store/graphStore.ts b/explorer/src/store/graphStore.tsindex f2663746..178c5236 100644--- a/explorer/src/store/graphStore.ts+++ b/explorer/src/store/graphStore.ts@@ -3,6 +3,7 @@ import type {GraphArrowVisibilityPolicy,GraphBadgeKind,GraphEdgeVariant,+ GraphEntityShapeVariant,GraphLabelVisibilityPolicy,GraphNodeShapeVariant,} from "../workspaces/GraphWorkspace/graphTheme";@@ -36,6 +37,7 @@ export interface NodeAttributes {borderSize?: number;nodeVariant?: GraphNodeShapeVariant;nodeShapeVariant?: GraphNodeShapeVariant;+ entityShape?: GraphEntityShapeVariant;badgeKind?: GraphBadgeKind;badgeCount?: number;ringColor?: string;diff --git a/explorer/src/workspaces/GraphWorkspace/GraphCanvas.tsx b/explorer/src/workspaces/GraphWorkspace/GraphCanvas.tsxindex 9f2b9398..6549751b 100644--- a/explorer/src/workspaces/GraphWorkspace/GraphCanvas.tsx+++ b/explorer/src/workspaces/GraphWorkspace/GraphCanvas.tsx@@ -25,6 +25,8 @@ import {collectInteractionRefreshTargets,createInteractionState,isEdgeInteractable,+ classifyFullGraphEdge,+ mapFullEdgeClassToVisualState,resolveEdgeElementStyle,resolveEdgeVisualState,resolveNodeElementStyle,@@ -47,6 +49,15 @@ import {drawSemanticaNodeHover,drawSemanticaNodeLabel,} from "./sigmaNativeRendering";+import {+ buildGraphStructureCurveCache,+ clearGraphStructureLayer,+ createGraphStructureCacheKey,+ drawGraphStructureLayer,+ evaluateGraphStructureLayerGate,+ getGraphStructureLayerDiagnostics,+ type GraphStructureCurveCache,+} from "./graphStructureLayer";import type {GraphAnalyticsSnapshot,GraphCameraState,@@ -54,8 +65,13 @@ import type {GraphDisplayStateSnapshot,GraphDiagnosticsSnapshot,GraphEffectsState,+ GraphFullEdgeClass,+ GraphFullEdgeClassCounts,+ GraphFullEdgeClassDiagnostics,GraphInteractionState,GraphLayoutStatus,+ GraphRuntimeDiagnosticsSnapshot,+ GraphStructureLayerDiagnostics,GraphTemporalState,GraphViewMode,} from "./types";@@ -98,7 +114,7 @@ export interface GraphCanvasProps {onSceneRuntimeChange?: (runtime: GraphSceneRuntime | null) => void;onInteractionStateChange?: (interactionState: GraphInteractionState) => void;onCameraStateChange?: (cameraState: GraphCameraState) => void;- onDiagnosticsChange?: (effectAvailability: GraphDiagnosticsSnapshot["effectAvailability"]) => void;+ onDiagnosticsChange?: (diagnostics: GraphRuntimeDiagnosticsSnapshot) => void;onAnalyticsChange?: (analytics: GraphAnalyticsSnapshot | null) => void;}@@ -800,6 +816,7 @@ function drawNodeBadge(}type ReducerSceneState = {+ viewMode: GraphViewMode;zoomTier: GraphZoomTier;hoveredNodeId: string | null;selectedNodeId: string;@@ -810,15 +827,133 @@ type ReducerSceneState = {edgeEndpointIds: Set<string>;pathNodeIds: Set<string>;pathEdgeIds: Set<string>;+ highlightedIncidentEdgeIds: Set<string>;overviewBackboneEdgeIds: Set<string>;};+const FULL_EDGE_CLASSES: GraphFullEdgeClass[] = [+ "hidden",+ "backbone",+ "bridge",+ "local-context",+ "selected",+ "path",+ "muted",+];++function createFullEdgeClassCounts(): GraphFullEdgeClassCounts {+ return FULL_EDGE_CLASSES.reduce((counts, edgeClass) => {+ counts[edgeClass] = 0;+ return counts;+ }, {} as GraphFullEdgeClassCounts);+}++function getIncidentEdgeRevealCap(viewMode: GraphViewMode, zoomTier: GraphZoomTier): number {+ return GRAPH_THEME.edges.contextCaps[viewMode]?.[zoomTier] ?? 0;+}++function scoreIncidentEdge(+ attrs: EdgeAttributes,+ edgeId: string,+ otherEndpointId: string,+ visibleNeighborIds: Set<string>,+ focusIds: Set<string>,+ pathEdgeIds: Set<string>,+ selectedEdgeId: string,+): number {+ if (pathEdgeIds.has(edgeId)) {+ return Number.POSITIVE_INFINITY;+ }+ if (selectedEdgeId && edgeId === selectedEdgeId) {+ return Number.POSITIVE_INFINITY;+ }++ const weight = Math.max(Number(attrs.weight ?? attrs.representativeWeight ?? 1) || 1, 1);+ const normalizedWeight = Math.min(1, Math.log1p(weight) / Math.log(25));+ const visualPriority = Math.max(0, Math.min(Number(attrs.visualPriority ?? 0), 1));+ const relationshipStrength = Math.max(0, Math.min(Number(attrs.relationshipStrength ?? 0), 1));++ return (visibleNeighborIds.has(otherEndpointId) ? 6 : 0)+ + (focusIds.has(otherEndpointId) ? 1.25 : 0)+ + visualPriority * 2+ + normalizedWeight * 1.4+ + relationshipStrength;+}++function buildHighlightedIncidentEdgeIds(+ displayGraph: GraphSceneGraph,+ interactionState: GraphInteractionState,+ displayState: GraphDisplayStateSnapshot | undefined,+ focusIds: Set<string>,+ pathEdgeIds: Set<string>,+): Set<string> {+ const primaryNodeId = interactionState.hoveredNodeId || interactionState.selectedNodeId;+ if (!primaryNodeId || !displayGraph.hasNode(primaryNodeId)) {+ return new Set();+ }++ const cap = getIncidentEdgeRevealCap(interactionState.viewMode, interactionState.zoomTier);+ if (cap <= 0 && !interactionState.selectedEdgeId && pathEdgeIds.size === 0) {+ return new Set();+ }++ const visibleNeighborIds = new Set(+ (displayState?.selectedVisibleNeighborIds ?? [])+ .filter((nodeId) => displayGraph.hasNode(nodeId)),+ );+ const candidates: Array<{ edgeId: string; score: number }> = [];++ displayGraph.edges(primaryNodeId).forEach((edge) => {+ const edgeId = String(edge);+ if (!displayGraph.hasEdge(edgeId)) {+ return;+ }+ const [source, target] = displayGraph.extremities(edgeId);+ const sourceId = String(source);+ const targetId = String(target);+ const otherEndpointId = sourceId === primaryNodeId ? targetId : sourceId;+ const attrs = displayGraph.getEdgeAttributes(edgeId) as EdgeAttributes;+ candidates.push({+ edgeId,+ score: scoreIncidentEdge(+ attrs,+ edgeId,+ otherEndpointId,+ visibleNeighborIds,+ focusIds,+ pathEdgeIds,+ interactionState.selectedEdgeId,+ ),+ });+ });++ candidates.sort((left, right) => {+ if (right.score !== left.score) {+ return right.score - left.score;+ }+ return left.edgeId.localeCompare(right.edgeId);+ });++ const selected = new Set<string>();+ candidates.forEach((candidate) => {+ if (+ candidate.edgeId === interactionState.selectedEdgeId+ || pathEdgeIds.has(candidate.edgeId)+ || selected.size < cap+ ) {+ selected.add(candidate.edgeId);+ }+ });+ return selected;+}+function buildReducerSceneState(displayGraph: GraphSceneGraph,interactionState: GraphInteractionState,- analyticsSnapshot: GraphAnalyticsSnapshot | null,+ displayState?: GraphDisplayStateSnapshot,+ analyticsSnapshot?: GraphAnalyticsSnapshot | null,): ReducerSceneState {- const { zoomTier, hoveredNodeId, selectedNodeId, selectedEdgeId, activePath } = interactionState;+ const { viewMode, zoomTier, hoveredNodeId, selectedNodeId, selectedEdgeId, activePath } = interactionState;const primaryNodeId = hoveredNodeId || selectedNodeId;const focusIds = primaryNodeId? (@@ -827,8 +962,10 @@ function buildReducerSceneState(: new Set<string>()): new Set<string>();+ const pathEdgeIds = buildPathEdgeSet(displayGraph, activePath, interactionState.activePathEdgeIds);return {+ viewMode,zoomTier,hoveredNodeId,selectedNodeId,@@ -838,8 +975,74 @@ function buildReducerSceneState(focusIds,edgeEndpointIds: buildEdgeEndpointSet(displayGraph, selectedEdgeId),pathNodeIds: new Set(activePath),- pathEdgeIds: buildPathEdgeSet(displayGraph, activePath, interactionState.activePathEdgeIds),+ pathEdgeIds,overviewBackboneEdgeIds: new Set(analyticsSnapshot?.overviewBackbone.edgeIds ?? []),+ highlightedIncidentEdgeIds: buildHighlightedIncidentEdgeIds(+ displayGraph,+ interactionState,+ displayState,+ focusIds,+ pathEdgeIds,+ ),+ };+}++function getFullGraphEdgeClass(+ displayGraph: GraphSceneGraph,+ edgeId: string,+ currentState: ReducerSceneState,+): GraphFullEdgeClass {+ if (!displayGraph.hasEdge(edgeId)) {+ return "hidden";+ }++ const [source, target] = displayGraph.extremities(edgeId);+ const sourceId = String(source);+ const targetId = String(target);+ const sourceAttrs = displayGraph.hasNode(sourceId)+ ? displayGraph.getNodeAttributes(sourceId) as NodeAttributes+ : undefined;+ const targetAttrs = displayGraph.hasNode(targetId)+ ? displayGraph.getNodeAttributes(targetId) as NodeAttributes+ : undefined;++ return classifyFullGraphEdge(+ edgeId,+ sourceId,+ targetId,+ currentState.zoomTier,+ currentState.hoveredNodeId,+ currentState.selectedNodeId,+ currentState.selectedEdgeId,+ currentState.focusIds,+ currentState.pathEdgeIds,+ currentState.highlightedIncidentEdgeIds,+ currentState.overviewBackboneEdgeIds,+ sourceAttrs,+ targetAttrs,+ );+}++function buildFullGraphEdgeClassDiagnostics(+ displayGraph: GraphSceneGraph,+ currentState: ReducerSceneState,+): GraphFullEdgeClassDiagnostics {+ const counts = createFullEdgeClassCounts();++ displayGraph.forEachEdge((edgeId) => {+ const edgeClass = currentState.viewMode === "full"+ ? getFullGraphEdgeClass(displayGraph, String(edgeId), currentState)+ : "hidden";+ counts[edgeClass] += 1;+ });++ return {+ mode: currentState.viewMode,+ zoomTier: currentState.zoomTier,+ totalEdges: displayGraph.size,+ visibleEdges: displayGraph.size - counts.hidden,+ counts,+ updatedAt: Date.now(),};}@@ -904,6 +1107,9 @@ function applySceneState(borderSize: style.borderSize,ringColor: style.showRing ? style.ringColor : style.borderColor,ringSize: style.ringSize,+ entityShape: style.entityShape,+ entityShapeKind: style.entityShapeKind,+ entityAspectRatio: style.entityAspectRatio,};});@@ -927,18 +1133,35 @@ function applySceneState(const attrs = data as EdgeAttributes;const [source, target] = currentGraph.extremities(edge);const stableEdgeId = String(edge);- const state = resolveEdgeVisualState(- stableEdgeId,- source,- target,- currentState.zoomTier,- currentState.hoveredNodeId,- currentState.selectedNodeId,- currentState.selectedEdgeId,- currentState.focusIds,- currentState.pathEdgeIds,- currentState.overviewBackboneEdgeIds,+ const hasActiveInteraction = Boolean(+ currentState.hoveredNodeId+ || currentState.selectedNodeId+ || currentState.selectedEdgeId+ || currentState.pathEdgeIds.size > 0,);+ const fullEdgeClass = currentState.viewMode === "full"+ ? getFullGraphEdgeClass(currentGraph, stableEdgeId, currentState)+ : undefined;+ const state = currentState.viewMode === "full"+ ? mapFullEdgeClassToVisualState(+ fullEdgeClass ?? "hidden",+ {+ hoveredNodeId: currentState.hoveredNodeId,+ hasActiveInteraction,+ },+ )+ : resolveEdgeVisualState(+ stableEdgeId,+ String(source),+ String(target),+ currentState.zoomTier,+ currentState.hoveredNodeId,+ currentState.selectedNodeId,+ currentState.selectedEdgeId,+ currentState.focusIds,+ currentState.pathEdgeIds,+ currentState.highlightedIncidentEdgeIds,+ );const style = resolveEdgeElementStyle(GRAPH_THEME,currentState.zoomTier,@@ -946,6 +1169,9 @@ function applySceneState(attrs,source,target,+ currentState.viewMode,+ stableEdgeId,+ fullEdgeClass,);return {@@ -1017,6 +1243,10 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>() {const containerRef = useRef<HTMLDivElement>(null);const overlayRef = useRef<HTMLCanvasElement>(null);+ const structureLayerCanvasRef = useRef<HTMLCanvasElement | null>(null);+ const structureLayerCacheRef = useRef<GraphStructureCurveCache | null>(null);+ const structureLayerLastDrawAtRef = useRef<number | null>(null);+ const structureLayerDiagnosticsRef = useRef<GraphStructureLayerDiagnostics | null>(null);const sigmaRef = useRef<Sigma | null>(null);const fa2Ref = useRef<FA2Layout | null>(null);const behaviorContextRef = useRef<GraphBehaviorContext | null>(null);@@ -1037,6 +1267,7 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(const [hoveredNodeId, setHoveredNodeId] = useState<string | null>(null);const [zoomTier, setZoomTier] = useState<GraphZoomTier>("overview");const [analyticsSnapshot, setAnalyticsSnapshot] = useState<GraphAnalyticsSnapshot | null>(null);+ const [layoutSettledEpoch, setLayoutSettledEpoch] = useState(0);const appliedGraphVersionRef = useRef<number | null>(null);const fittedDisplaySignatureRef = useRef<DisplayFitSignature | null>(null);const layoutSyncFrameRef = useRef<number | null>(null);@@ -1100,6 +1331,12 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(const interactionStateRef = useRef<GraphInteractionState>(interactionState);interactionStateRef.current = interactionState;const previousInteractionStateRef = useRef<GraphInteractionState | null>(null);+ useEffect(() => {+ if (!isLayoutRunning) {+ setLayoutSettledEpoch((epoch) => epoch + 1);+ }+ }, [displayGraph, graphVersion, isLayoutRunning]);+const shouldComputeCommunities = effectsState.communitiesEnabled || effectsState.semanticRegionsEnabled;const shouldComputeCentrality = effectsState.centralityEnabled || effectsState.semanticRegionsEnabled || effectsState.contoursEnabled;const analyticsBase = useMemo(@@ -1110,11 +1347,55 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>([displayGraph, shouldComputeCentrality, shouldComputeCommunities],);const reducerSceneState = useMemo(- () => buildReducerSceneState(displayGraph, interactionState, analyticsSnapshot),- [analyticsSnapshot, displayGraph, interactionState],+ () => buildReducerSceneState(displayGraph, interactionState, displayState, analyticsSnapshot),+ [analyticsSnapshot, displayGraph, displayState, interactionState],);const reducerSceneStateRef = useRef<ReducerSceneState>(reducerSceneState);reducerSceneStateRef.current = reducerSceneState;+ const edgeClassDiagnostics = useMemo(+ () => buildFullGraphEdgeClassDiagnostics(displayGraph, reducerSceneState),+ [displayGraph, reducerSceneState],+ );+ const structureLayerGate = useMemo(+ () => evaluateGraphStructureLayerGate({+ mode: GRAPH_THEME.edges.fullGraphStructureLayer.mode,+ viewMode,+ isLayoutRunning,+ edgeDiagnostics: edgeClassDiagnostics,+ minimumLiteralEdges: GRAPH_THEME.edges.fullGraphStructureLayer.minimumLiteralEdges,+ }),+ [edgeClassDiagnostics, isLayoutRunning, viewMode],+ );+ const structureLayerCache = useMemo(() => {+ if (!structureLayerGate.enabled) {+ return null;+ }+ const cacheKey = createGraphStructureCacheKey({+ graphVersion,+ zoomTier,+ layoutSettledEpoch,+ overviewBackboneEdgeIds: reducerSceneState.overviewBackboneEdgeIds,+ });+ return buildGraphStructureCurveCache({+ graphRef: displayGraph,+ cacheKey,+ classifyEdge: (edgeId) => getFullGraphEdgeClass(displayGraph, edgeId, reducerSceneState),+ maxCurves: GRAPH_THEME.edges.fullGraphStructureLayer.maxCurves,+ curveStrength: GRAPH_THEME.edges.fullGraphStructureLayer.curveStrength,+ });+ }, [displayGraph, graphVersion, layoutSettledEpoch, reducerSceneState, structureLayerGate.enabled, zoomTier]);+ structureLayerCacheRef.current = structureLayerCache;+ const structureLayerDiagnostics = useMemo(+ () => getGraphStructureLayerDiagnostics({+ gate: structureLayerGate,+ cache: structureLayerCache,+ minimumCurves: GRAPH_THEME.edges.fullGraphStructureLayer.minimumCurves,+ canvasAvailable: Boolean(structureLayerCanvasRef.current),+ lastDrawAt: structureLayerLastDrawAtRef.current,+ }),+ [structureLayerCache, structureLayerGate],+ );+ structureLayerDiagnosticsRef.current = structureLayerDiagnostics;const displayFitSignature = useMemo<DisplayFitSignature>(() => ({graphVersion,viewMode,@@ -1237,17 +1518,40 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(graphVersion: graphVersionRef.current,viewMode: viewModeRef.current,});- fitDisplayGraphInView();return;}- const bounds = computeGraphSpaceBounds(currentDisplayGraph, selectionNodeIds);+ const selectedDisplayNodeId = selectionNodeIds[0];+ const selectedDisplayData = sigma.getNodeDisplayData(selectedDisplayNodeId);+ if (selectedDisplayData) {+ const viewportPoint = sigma.graphToViewport({+ x: selectedDisplayData.x,+ y: selectedDisplayData.y,+ });+ const dimensions = sigma.getDimensions();+ if (isPointNearViewport(viewportPoint, dimensions.width, dimensions.height, 96)) {+ debugGraphRuntime("camera-selection-visible-noop", {+ nodeId,+ selectedDisplayNodeId,+ graphVersion: graphVersionRef.current,+ viewMode: viewModeRef.current,+ viewportX: viewportPoint.x,+ viewportY: viewportPoint.y,+ });+ sigma.scheduleRefresh();+ return;+ }+ }++ const bounds = computeDisplayedNodeBounds(sigma, selectionNodeIds);if (!bounds) {if (attempt < 3) {- debugGraphRuntime("camera-selection-deferred", {+ debugGraphRuntime("camera-selection-display-bounds-deferred", {nodeId,graphVersion: graphVersionRef.current,attempt: attempt + 1,+ viewMode: viewModeRef.current,+ contextCount: selectionNodeIds.length,});if (deferredFocusFrameRef.current !== null) {window.cancelAnimationFrame(deferredFocusFrameRef.current);@@ -1257,45 +1561,43 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(centerSelectionInViewInternal(nodeId, attempt + 1);});} else {- debugGraphRuntime("camera-selection-fallback-fit", {+ debugGraphRuntime("camera-selection-display-bounds-fallback-fit", {nodeId,graphVersion: graphVersionRef.current,viewMode: viewModeRef.current,+ contextCount: selectionNodeIds.length,});- fitDisplayGraphInView();}return;}- const globalBounds = computeDisplayedGraphBounds(sigma, currentDisplayGraph);- const selectionBBox = expandGraphSpaceBounds(bounds, globalBounds, {- paddingRatio: 0.2,- minSpanRatio: 0.035,- minSpanFloor: 0.02,- });- if (!selectionBBox) {- debugGraphRuntime("camera-selection-invalid-bounds", {- nodeId,- graphVersion: graphVersionRef.current,- count: bounds.count,- });- fitDisplayGraphInView();- return;- }+ const camera = sigma.getCamera();+ const currentCameraState = camera.getState();+ const target = {+ x: (bounds.minX + bounds.maxX) / 2,+ y: (bounds.minY + bounds.maxY) / 2,+ ratio: currentCameraState.ratio,+ angle: currentCameraState.angle,+ };- animateCameraToBounds("fit-selection-context", selectionBBox, {+ debugGraphRuntime("camera-selection-gentle-center", {nodeId,contextCount: bounds.count,+ boundsSource: "displayed-selection-context",minX: bounds.minX,maxX: bounds.maxX,minY: bounds.minY,maxY: bounds.maxY,- referenceMinX: globalBounds?.minX ?? null,- referenceMaxX: globalBounds?.maxX ?? null,- referenceMinY: globalBounds?.minY ?? null,- referenceMaxY: globalBounds?.maxY ?? null,+ targetX: target.x,+ targetY: target.y,+ preservedRatio: target.ratio,});- }, [animateCameraToBounds, fitDisplayGraphInView]);++ void camera.animate(+ target,+ { duration: GRAPH_THEME.motion.cameraMs, easing: "quadraticOut" },+ );+ }, []);const centerGroupedSelectionInView = useCallback((nodeId: string) => {const sigma = sigmaRef.current;@@ -1580,6 +1882,22 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(}});+ try {+ const structureCanvas = sigma.createCanvas("structure", {+ beforeLayer: "nodes",+ afterLayer: "edges",+ style: {+ pointerEvents: "none",+ },+ });+ structureLayerCanvasRef.current = structureCanvas;+ } catch (error) {+ debugGraphRuntime("structure-layer-create-failed", {+ error: error instanceof Error ? error.message : String(error),+ });+ structureLayerCanvasRef.current = null;+ }+requestAnimationFrame(() => {syncCameraState(sigma);});@@ -1607,6 +1925,14 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(debugGraphRuntime("sigma-killed", {graphVersion: graphVersionRef.current,});+ if (structureLayerCanvasRef.current) {+ try {+ sigma.killLayer("structure");+ } catch {+ // Sigma.kill() also cleans layers; ignore if already removed.+ }+ }+ structureLayerCanvasRef.current = null;sigma.kill();}if (deferredFocusFrameRef.current !== null) {@@ -1764,8 +2090,24 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(container?.clientWidth ?? 0,container?.clientHeight ?? 0,);- onDiagnosticsChange(availability);- }, [analyticsSnapshot, effectsState, interactionState, isLayoutRunning, onDiagnosticsChange, temporalState]);+ onDiagnosticsChange({+ effectAvailability: availability,+ edgeClasses: edgeClassDiagnostics,+ structureLayer: structureLayerDiagnosticsRef.current ?? structureLayerDiagnostics,+ });+ if (import.meta.env.DEV && effectsState.diagnosticsEnabled) {+ console.debug("[Edge Truth]", edgeClassDiagnostics);+ }+ }, [+ analyticsSnapshot,+ edgeClassDiagnostics,+ effectsState,+ interactionState,+ isLayoutRunning,+ onDiagnosticsChange,+ structureLayerDiagnostics,+ temporalState,+ ]);useEffect(() => {previousInteractionStateRef.current = null;@@ -1786,6 +2128,59 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(previousInteractionStateRef.current = interactionState;}, [displayGraph, interactionState, reducerSceneStateRef]);+ const drawStructureLayerFrame = useCallback(() => {+ const sigma = sigmaRef.current;+ const canvas = structureLayerCanvasRef.current;+ const cache = structureLayerCacheRef.current;+ const diagnostics = getGraphStructureLayerDiagnostics({+ gate: structureLayerGate,+ cache,+ minimumCurves: GRAPH_THEME.edges.fullGraphStructureLayer.minimumCurves,+ canvasAvailable: Boolean(canvas),+ lastDrawAt: structureLayerLastDrawAtRef.current,+ });+ structureLayerDiagnosticsRef.current = diagnostics;++ if (!sigma || !canvas || !diagnostics.enabled || !cache) {+ clearGraphStructureLayer(canvas);+ return;+ }++ const drawn = drawGraphStructureLayer({+ sigma,+ canvas,+ cache,+ });+ if (drawn) {+ structureLayerLastDrawAtRef.current = Date.now();+ structureLayerDiagnosticsRef.current = {+ ...diagnostics,+ lastDrawAt: structureLayerLastDrawAtRef.current,+ };+ }+ }, [structureLayerGate]);++ useEffect(() => {+ const sigma = sigmaRef.current;+ if (!graphReady || !sigma) {+ return;+ }++ const draw = () => drawStructureLayerFrame();+ sigma.on("afterRender", draw);+ draw();++ return () => {+ sigma.off("afterRender", draw);+ };+ }, [drawStructureLayerFrame, graphReady, structureLayerCache]);++ useEffect(() => {+ if (isLayoutRunning || viewMode !== "full") {+ clearGraphStructureLayer(structureLayerCanvasRef.current);+ }+ }, [isLayoutRunning, viewMode]);+const drawOverlayFrame = useCallback(() => {const sigma = sigmaRef.current;const overlay = overlayRef.current;@@ -1847,6 +2242,19 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(...pathNodeIds,...(primaryNodeId ? [primaryNodeId] : []),]);+ const lensFocusIds = new Set<string>();+ if (primaryNodeId) {+ reducerSceneStateRef.current.highlightedIncidentEdgeIds.forEach((edgeId) => {+ if (!displayGraph.hasEdge(edgeId)) {+ return;+ }+ const [source, target] = displayGraph.extremities(edgeId);+ const otherEndpointId = String(source) === primaryNodeId ? String(target) : String(source);+ if (displayGraph.hasNode(otherEndpointId)) {+ lensFocusIds.add(otherEndpointId);+ }+ });+ }const now = performance.now() / 1000;if (!isLayoutRunning) {@@ -1909,7 +2317,7 @@ export const GraphCanvas = forwardRef<GraphCanvasHandle, GraphCanvasProps>(});if (!isLayoutRunning && primaryNodeId && effectAvailability.lens.available) {- drawLensLayer(context, sigma, primaryNodeId, focusIds);+ drawLensLayer(context, sigma, primaryNodeId, lensFocusIds);}drawPathEffectsLayer(context, pathSegments, effectsState, effectAvailability, now);diff --git a/explorer/src/workspaces/GraphWorkspace/GraphInspectorPanel.tsx b/explorer/src/workspaces/GraphWorkspace/GraphInspectorPanel.tsxindex 7b7103a1..6f65534c 100644--- a/explorer/src/workspaces/GraphWorkspace/GraphInspectorPanel.tsx+++ b/explorer/src/workspaces/GraphWorkspace/GraphInspectorPanel.tsx@@ -172,10 +172,10 @@ export function GraphInspectorPanel({if (!nodeId) {return (<div style={{ padding: 32, textAlign: "center", display: "flex", flexDirection: "column", alignItems: "center", gap: 12, marginTop: 32 }}>- <div style={{ width: 40, height: 40, borderRadius: "50%", background: "rgba(74,163,255,0.08)", border: "1px solid rgba(74,163,255,0.14)", display: "flex", alignItems: "center", justifyContent: "center" }}>- <div style={{ width: 14, height: 14, borderRadius: "50%", background: "rgba(127,208,255,0.3)" }} />+ <div style={{ width: 40, height: 40, borderRadius: "50%", background: "rgba(98, 226, 205, 0.07)", border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`, display: "flex", alignItems: "center", justifyContent: "center" }}>+ <div style={{ width: 14, height: 14, borderRadius: "50%", background: GRAPH_THEME.ui.timeline.playheadSoft }} /></div>- <p style={{ color: "#8b949e", fontSize: 14, margin: 0, lineHeight: 1.6 }}>+ <p style={{ color: GRAPH_THEME.ui.text.muted, fontSize: 14, margin: 0, lineHeight: 1.6 }}>Search for a node or click one in the canvas to inspect its properties.</p></div>@@ -191,19 +191,19 @@ export function GraphInspectorPanel({if (!effectiveNodeId) {return (<aside style={{ padding: 24, display: "flex", flexDirection: "column", gap: 16 }}>- <div style={{ borderBottom: "1px solid rgba(88, 166, 255, 0.2)", paddingBottom: 16 }}>+ <div style={{ borderBottom: `1px solid ${GRAPH_THEME.ui.surface.divider}`, paddingBottom: 16 }}><div style={{ display: "flex", alignItems: "center", gap: 10, marginBottom: 8 }}>- <span style={{ background: "#58a6ff", boxShadow: "0 0 10px rgba(88,166,255,0.45)", width: 8, height: 8, borderRadius: "50%" }} />- <span style={{ color: "#58a6ff", fontSize: 12, fontWeight: 700 }}>Selection</span>+ <span style={{ background: GRAPH_THEME.ui.timeline.playhead, boxShadow: "0 0 10px rgba(98, 226, 205, 0.34)", width: 8, height: 8, borderRadius: "50%" }} />+ <span style={{ color: GRAPH_THEME.ui.timeline.playhead, fontSize: 12, fontWeight: 700 }}>Selection</span></div>- <h3 style={{ margin: 0, color: "#fff", fontSize: 20, fontWeight: 700, wordBreak: "break-word" }}>+ <h3 style={{ margin: 0, color: GRAPH_THEME.ui.text.strong, fontSize: 20, fontWeight: 700, wordBreak: "break-word" }}>{nodeId}</h3>- <div style={{ color: "#8b949e", fontSize: 12, marginTop: 6, fontFamily: "monospace", wordBreak: "break-all" }}>{nodeId}</div>+ <div style={{ color: GRAPH_THEME.ui.text.muted, fontSize: 12, marginTop: 6, fontFamily: "monospace", wordBreak: "break-all" }}>{nodeId}</div></div><div style={groupedSelectionNoticeStyle}>- <div style={{ color: "#dbe9f7", fontWeight: 600, marginBottom: 6 }}>Selected item is not directly inspectable in the current graph.</div>- <div style={{ color: "#8fa8c6", fontSize: 13, lineHeight: 1.6 }}>+ <div style={{ color: GRAPH_THEME.ui.text.strong, fontWeight: 600, marginBottom: 6 }}>Selected item is not directly inspectable in the current graph.</div>+ <div style={{ color: GRAPH_THEME.ui.text.body, fontSize: 13, lineHeight: 1.6 }}>{canActivateFocused? "Activate Focused mode to resolve this grouped selection to its canonical node.": (focusedUnavailableReason ?? "Focused mode is unavailable for the current selection.")}@@ -233,23 +233,23 @@ export function GraphInspectorPanel({return (<aside style={{ padding: 24, display: "flex", flexDirection: "column", gap: 18 }}>{/* Node identity */}- <div style={{ borderBottom: "1px solid rgba(88, 166, 255, 0.2)", paddingBottom: 16 }}>+ <div style={{ borderBottom: `1px solid ${GRAPH_THEME.ui.surface.divider}`, paddingBottom: 16 }}><div style={{ display: "flex", alignItems: "center", gap: 10, marginBottom: 8 }}><span style={{ background: accentColor, boxShadow: `0 0 10px ${accentColor}`, width: 8, height: 8, borderRadius: "50%" }} /><span style={{ color: accentColor, fontSize: 12, fontWeight: 700 }}>{groupedDisplaySelection ? "Grouped Selection" : (attributes?.nodeType || "Entity")}</span></div>- <h3 style={{ margin: 0, color: "#fff", fontSize: 20, fontWeight: 700, wordBreak: "break-word" }}>+ <h3 style={{ margin: 0, color: GRAPH_THEME.ui.text.strong, fontSize: 20, fontWeight: 700, wordBreak: "break-word" }}>{String(attributes?.label ?? effectiveNodeId)}</h3>- <div style={{ color: "#8b949e", fontSize: 12, marginTop: 6, fontFamily: "monospace", wordBreak: "break-all" }}>+ <div style={{ color: GRAPH_THEME.ui.text.muted, fontSize: 12, marginTop: 6, fontFamily: "monospace", wordBreak: "break-all" }}>{groupedDisplaySelection ? nodeId : effectiveNodeId}</div>{groupedDisplaySelection ? (<div style={groupedSelectionNoticeStyle}>- <div style={{ color: "#dbe9f7", fontWeight: 600, marginBottom: 6 }}>This grouped item stays display-level until you explicitly enter Focused mode.</div>- <div style={{ color: "#8fa8c6", fontSize: 13, lineHeight: 1.6 }}>+ <div style={{ color: GRAPH_THEME.ui.text.strong, fontWeight: 600, marginBottom: 6 }}>This grouped item stays display-level until you explicitly enter Focused mode.</div>+ <div style={{ color: GRAPH_THEME.ui.text.body, fontSize: 13, lineHeight: 1.6 }}>{canActivateFocused? `Canonical node available: ${effectiveNodeId}`: (focusedUnavailableReason ?? "Focused mode is unavailable for the current selection.")}@@ -267,7 +267,7 @@ export function GraphInspectorPanel({{/* Temporal bounds */}{(attributes?.valid_from || attributes?.valid_until) ? (- <div style={{ padding: "10px 12px", background: "rgba(88,166,255,0.08)", border: "1px solid rgba(88,166,255,0.2)", borderRadius: 8, fontSize: 12, color: "#79c0ff", fontFamily: "monospace" }}>+ <div style={{ padding: "10px 12px", background: "rgba(233, 196, 122, 0.075)", border: "1px solid rgba(233, 196, 122, 0.22)", borderRadius: 8, fontSize: 12, color: GRAPH_THEME.palette.accent.selected, fontFamily: "monospace" }}>{attributes?.valid_from ? <div>from: {attributes.valid_from}</div> : null}{attributes?.valid_until ? <div>until: {attributes.valid_until}</div> : null}</div>@@ -343,8 +343,8 @@ export function GraphInspectorPanel({><div style={{ display: "flex", justifyContent: "space-between", alignItems: "flex-start", gap: 8 }}><div>- <div style={{ color: "#fff", fontWeight: 600 }}>{prediction.label || prediction.target}</div>- <div style={{ color: "#8b949e", fontSize: 12 }}>{prediction.type}</div>+ <div style={{ color: GRAPH_THEME.ui.text.strong, fontWeight: 600 }}>{prediction.label || prediction.target}</div>+ <div style={{ color: GRAPH_THEME.ui.text.muted, fontSize: 12 }}>{prediction.type}</div></div><div style={{ flexShrink: 0 }}><div style={{@@ -352,9 +352,9 @@ export function GraphInspectorPanel({borderRadius: 999,fontSize: 10,fontWeight: 700,- background: "rgba(88,166,255,0.12)",- border: "1px solid rgba(88,166,255,0.22)",- color: "#58a6ff",+ background: GRAPH_THEME.ui.timeline.playheadSoft,+ border: `1px solid ${GRAPH_THEME.ui.control.activeBorder}`,+ color: GRAPH_THEME.ui.timeline.playhead,}}>{(prediction.score * 100).toFixed(1)}%</div>@@ -382,8 +382,8 @@ export function GraphInspectorPanel({<div style={{ display: "flex", flexDirection: "column", gap: 8 }}>{attribution.map(({ key, value }) => (<div key={key} style={propertyCardStyle}>- <div style={{ color: "rgba(88,166,255,0.7)", fontSize: 11, marginBottom: 4 }}>{key}</div>- <div style={{ color: "#e6edf3", fontSize: 13, wordBreak: "break-word" }}>+ <div style={{ color: GRAPH_THEME.ui.timeline.playhead, fontSize: 11, marginBottom: 4 }}>{key}</div>+ <div style={{ color: GRAPH_THEME.ui.text.body, fontSize: 13, wordBreak: "break-word" }}>{typeof value === "object" ? JSON.stringify(value) : String(value)}</div></div>@@ -403,8 +403,8 @@ export function GraphInspectorPanel({<div style={{ display: "flex", flexDirection: "column", gap: 8 }}>{propertyEntries.map(([key, value]) => (<div key={key} style={propertyCardStyle}>- <div style={{ color: "rgba(88,166,255,0.7)", fontSize: 11, marginBottom: 4 }}>{key}</div>- <div style={{ color: "#e6edf3", fontSize: 13, wordBreak: "break-word" }}>+ <div style={{ color: GRAPH_THEME.ui.timeline.playhead, fontSize: 11, marginBottom: 4 }}>{key}</div>+ <div style={{ color: GRAPH_THEME.ui.text.body, fontSize: 13, wordBreak: "break-word" }}>{typeof value === "object" ? JSON.stringify(value) : String(value)}</div></div>@@ -423,27 +423,27 @@ export function GraphInspectorPanel({const inputStyle: CSSProperties = {width: "100%",- background: "rgba(4, 10, 18, 0.5)",- border: `1px solid ${GRAPH_THEME.palette.background.shellBorder}`,- color: "#edf5ff",+ background: GRAPH_THEME.ui.control.inputBg,+ border: `1px solid ${GRAPH_THEME.ui.control.inputBorder}`,+ color: GRAPH_THEME.ui.text.strong,borderRadius: 12,padding: "11px 13px",fontSize: 13,- boxShadow: "inset 0 1px 0 rgba(255,255,255,0.03)",+ boxShadow: "inset 0 1px 0 rgba(255,255,255,0.035)",};const groupedSelectionNoticeStyle: CSSProperties = {marginTop: 12,padding: "10px 12px",- background: "rgba(88,166,255,0.08)",- border: "1px solid rgba(88,166,255,0.2)",+ background: "rgba(98, 226, 205, 0.07)",+ border: `1px solid ${GRAPH_THEME.ui.control.activeBorder}`,borderRadius: 12,};const actionButtonStyle: CSSProperties = {- background: "linear-gradient(135deg, rgba(24, 63, 133, 0.42), rgba(35, 85, 176, 0.28))",- color: "#fff",- border: `1px solid ${GRAPH_THEME.palette.background.shellBorder}`,+ background: GRAPH_THEME.ui.control.primaryBg,+ color: GRAPH_THEME.ui.control.primaryText,+ border: `1px solid ${GRAPH_THEME.ui.control.primaryBorder}`,borderRadius: 12,padding: "9px 12px",cursor: "pointer",@@ -452,47 +452,47 @@ const actionButtonStyle: CSSProperties = {display: "inline-flex",alignItems: "center",justifyContent: "center",- boxShadow: `0 8px 22px ${GRAPH_THEME.palette.background.shellGlow}`,+ boxShadow: "inset 0 1px 0 rgba(255,255,255,0.07), 0 10px 24px rgba(0,0,0,0.18)",};const secondaryActionButtonStyle: CSSProperties = {...actionButtonStyle,- background: "rgba(255, 255, 255, 0.03)",- border: "1px solid rgba(255, 255, 255, 0.08)",- color: "#c6d4e3",+ background: GRAPH_THEME.ui.control.defaultBg,+ border: `1px solid ${GRAPH_THEME.ui.control.defaultBorder}`,+ color: GRAPH_THEME.ui.control.defaultText,fontWeight: 600,};const predictionCardStyle: CSSProperties = {textAlign: "left",padding: "10px 12px",- background: "rgba(88, 166, 255, 0.08)",- border: "1px solid rgba(88, 166, 255, 0.12)",+ background: "rgba(255, 255, 255, 0.035)",+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,borderRadius: 10,cursor: "pointer",width: "100%",};const propertyCardStyle: CSSProperties = {- background: "rgba(0, 0, 0, 0.2)",+ background: "rgba(255, 255, 255, 0.028)",padding: "10px 12px",borderRadius: 10,- border: "1px solid rgba(255, 255, 255, 0.05)",+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,};const emptyTextStyle: CSSProperties = {- color: "#8b949e",+ color: GRAPH_THEME.ui.text.muted,fontSize: 12,lineHeight: 1.5,};const subtleChipStyle: CSSProperties = {background: "rgba(255, 255, 255, 0.04)",- color: "#9fb6d2",+ color: GRAPH_THEME.ui.text.body,padding: "4px 8px",borderRadius: 999,fontSize: 11,- border: "1px solid rgba(255, 255, 255, 0.06)",+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,};const sectionStyle: CSSProperties = {@@ -500,13 +500,13 @@ const sectionStyle: CSSProperties = {flexDirection: "column",gap: 10,padding: 14,- background: "linear-gradient(180deg, rgba(255,255,255,0.03), rgba(255,255,255,0.015))",- border: "1px solid rgba(255, 255, 255, 0.06)",+ background: GRAPH_THEME.ui.surface.cardSubtle,+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,borderRadius: 14,};const sectionTitleStyle: CSSProperties = {- color: "#8b949e",+ color: GRAPH_THEME.ui.text.muted,fontSize: 11,fontWeight: 700,textTransform: "uppercase",@@ -527,9 +527,9 @@ const pathNodeChipStyle: CSSProperties = {gap: 6,padding: "5px 10px",borderRadius: 999,- background: "rgba(88,166,255,0.1)",- border: "1px solid rgba(88,166,255,0.22)",- color: "#e6edf3",+ background: "rgba(98, 226, 205, 0.08)",+ border: `1px solid ${GRAPH_THEME.ui.control.activeBorder}`,+ color: GRAPH_THEME.ui.text.strong,fontSize: 12,fontWeight: 600,maxWidth: 160,@@ -542,8 +542,8 @@ const pathNodeIndexStyle: CSSProperties = {width: 16,height: 16,borderRadius: "50%",- background: "rgba(88,166,255,0.22)",- color: "#79c0ff",+ background: GRAPH_THEME.ui.timeline.playheadSoft,+ color: GRAPH_THEME.ui.timeline.playhead,fontSize: 9,fontWeight: 800,flexShrink: 0,@@ -559,7 +559,7 @@ const pathEdgeConnectorStyle: CSSProperties = {const pathEdgeLabelStyle: CSSProperties = {fontSize: 9,fontWeight: 700,- color: "#6a7f97",+ color: GRAPH_THEME.ui.text.subtle,letterSpacing: "0.04em",textTransform: "uppercase",maxWidth: 70,diff --git a/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx b/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsxindex 06475e17..4e3e7e18 100644--- a/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx+++ b/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx@@ -1,4 +1,20 @@-import { useCallback, useEffect, useMemo, useRef, useState } from "react";+import { useCallback, useEffect, useMemo, useRef, useState, type ComponentType, type ReactNode } from "react";+import {+ Activity,+ Clock3,+ Eye,+ Focus,+ GitBranch,+ Layers3,+ Maximize2,+ Pause,+ Play,+ RefreshCw,+ Search,+ Users,+ ZoomIn,+ ZoomOut,+} from "lucide-react";import type Graph from "graphology";import { batchMergeEdges, batchMergeNodes, graph } from "../../store/graphStore";@@ -12,6 +28,7 @@ import { useLoadGraph, useReloadGraph } from "./useLoadGraph";import { GraphLoadingOverlay } from "./GraphLoadingOverlay";import { createGraphLoadProgress, getGraphLoadTitle } from "./graphLoading";import { GRAPH_THEME, withAlpha } from "./graphTheme";+import type { GraphEntityShapeVariant } from "./graphTheme";import { checkGroupedViewAvailability, resolveDisplayGraph, resolveDisplayStateSnapshot, resolveGroupedDisplayNodeId, resolveGroupedDisplayStateSnapshot } from "./graphSceneState";import {type GraphPlugin,@@ -32,6 +49,7 @@ import type {GraphInteractionState,GraphLoadProgress,GraphLoadSummary,+ GraphRuntimeDiagnosticsSnapshot,GraphSelectedEdgeState,GraphSelectedNodeKind,GraphSelectedNodeState,@@ -59,6 +77,12 @@ type ExploreLayoutState = {showPluginDock: boolean;};+type ToolbarIconComponent = ComponentType<{+ size?: number;+ strokeWidth?: number;+ "aria-hidden"?: boolean;+}>;+type GraphToolbarItem = {id: string;label: string;@@ -66,11 +90,16 @@ type GraphToolbarItem = {active?: boolean;disabled?: boolean;tone?: "primary" | "secondary";+ icon?: ToolbarIconComponent;+ ariaLabel?: string;+ compact?: boolean;onClick: () => void;};type GraphToolbarGroup = {id: string;+ label?: string;+ variant?: "cluster" | "segmented";items: GraphToolbarItem[];};@@ -110,6 +139,15 @@ const loadExplorationEffectsPlugin = () => import("./plugins/explorationEffectsPconst loadNeighborhoodPanelPlugin = () => import("./plugins/neighborhoodPanelPlugin").then((module) => module.neighborhoodPanelPlugin);const loadTemporalOverlayPlugin = () => import("./plugins/temporalOverlayPlugin").then((module) => module.temporalOverlayPlugin);const EMPTY_PATH: string[] = [];+const COMPACT_TOOLBAR_CLUSTER_IDS = new Set(["camera", "utility"]);+const ENTITY_VISUAL_KEY: Array<{ shape: GraphEntityShapeVariant; label: string }> = [+ { shape: "biomolecule", label: "Biomolecule" },+ { shape: "condition", label: "Condition" },+ { shape: "compound", label: "Compound" },+ { shape: "process", label: "Process" },+ { shape: "community", label: "Community" },+ { shape: "entity", label: "Other" },+];const DEBUG_GRAPH_WORKSPACE = import.meta.env.DEV;function debugGraphWorkspace(message: string, payload?: Record<string, unknown>) {@@ -128,49 +166,187 @@ function useDebounce<T>(value: T, delay: number): T {return debouncedValue;}+function iconForPluginToolbarItem(item: GraphPluginToolbarItem): ToolbarIconComponent {+ const normalized = `${item.id} ${item.label}`.toLowerCase();+ if (normalized.includes("neighbor")) {+ return Users;+ }+ if (normalized.includes("temporal") || normalized.includes("time")) {+ return Clock3;+ }+ return Activity;+}++function ToolbarIcon({ icon: Icon, size = 15 }: { icon?: ToolbarIconComponent; size?: number }) {+ if (!Icon) {+ return null;+ }++ return <Icon size={size} strokeWidth={2.15} aria-hidden />;+}++function ToolbarButton({+ item,+ compact = false,+ className = "",+}: {+ item: GraphToolbarItem;+ compact?: boolean;+ className?: string;+}) {+ const isCompact = compact || item.compact;+ return (+ <button+ type="button"+ className={`explore-tool-button ${item.tone === "primary" ? "explore-tool-button-primary" : ""} ${className}`}+ data-active={item.active ? "true" : "false"}+ data-compact={isCompact ? "true" : "false"}+ onClick={item.onClick}+ title={item.title}+ aria-label={item.ariaLabel ?? item.label}+ disabled={item.disabled}+ >+ <ToolbarIcon icon={item.icon} size={isCompact ? 14 : 15} />+ <span className="explore-tool-button-label">{item.label}</span>+ </button>+ );+}++function ToolbarCluster({+ label,+ items,+ compact = false,+ children,+}: {+ label: string;+ items?: GraphToolbarItem[];+ compact?: boolean;+ children?: ReactNode;+}) {+ if ((!items || items.length === 0) && !children) {+ return null;+ }++ return (+ <div className="explore-tool-cluster" aria-label={label}>+ <div className="explore-tool-cluster-label">{label}</div>+ <div className="explore-tool-cluster-items">+ {children}+ {items?.map((item) => (+ <ToolbarButton key={item.id} item={item} compact={compact} />+ ))}+ </div>+ </div>+ );+}++function SegmentedModeControl({ items }: { items: GraphToolbarItem[] }) {+ if (!items.length) {+ return null;+ }++ return (+ <div className="explore-mode-control" role="group" aria-label="Graph view mode">+ {items.map((item) => (+ <ToolbarButton key={item.id} item={item} className="explore-mode-segment" />+ ))}+ </div>+ );+}++function SearchCommandBar({+ value,+ disabled,+ onChange,+ onSubmit,+}: {+ value: string;+ disabled: boolean;+ onChange: (value: string) => void;+ onSubmit: () => void;+}) {+ return (+ <form+ className="explore-search-command"+ onSubmit={(event) => {+ event.preventDefault();+ if (!disabled) {+ onSubmit();+ }+ }}+ >+ <Search size={17} strokeWidth={2.15} aria-hidden />+ <input+ value={value}+ onChange={(event) => onChange(event.target.value)}+ placeholder="Search command, node, or concept"+ aria-label="Search graph nodes"+ />+ <button type="submit" disabled={disabled} aria-label="Search for the current query">+ Search+ </button>+ </form>+ );+}++function EntityVisualKey() {+ return (+ <div className="explore-entity-key" aria-label="Node visual key">+ {ENTITY_VISUAL_KEY.map((item) => (+ <div key={item.shape} className="explore-entity-key-item">+ <span className="explore-entity-key-mark" data-shape={item.shape} />+ <span>{item.label}</span>+ </div>+ ))}+ </div>+ );+}+const HUD_CSS = `.palantir-bg {background:- radial-gradient(circle at top, rgba(77, 157, 255, 0.08), transparent 22%),- linear-gradient(180deg, #060b17 0%, #02060d 100%);+ ${GRAPH_THEME.ui.scene.radialGlow},+ ${GRAPH_THEME.ui.scene.background};}.palantir-grid {position: absolute;inset: 0;background-image:- linear-gradient(rgba(88, 166, 255, 0.038) 1px, transparent 1px),- linear-gradient(90deg, rgba(88, 166, 255, 0.038) 1px, transparent 1px);- background-size: 42px 42px;+ linear-gradient(${GRAPH_THEME.ui.scene.grid} 1px, transparent 1px),+ linear-gradient(90deg, ${GRAPH_THEME.ui.scene.grid} 1px, transparent 1px),+ linear-gradient(${GRAPH_THEME.ui.scene.gridStrong} 1px, transparent 1px),+ linear-gradient(90deg, ${GRAPH_THEME.ui.scene.gridStrong} 1px, transparent 1px);+ background-size: 48px 48px, 48px 48px, 240px 240px, 240px 240px;pointer-events: none;z-index: 1;}.palantir-vignette {position: absolute;inset: 0;- background: radial-gradient(ellipse at center, transparent 34%, rgba(1, 4, 10, 0.78) 100%);+ background: ${GRAPH_THEME.ui.scene.vignette};pointer-events: none;z-index: 2;}.glass-header {- background: linear-gradient(180deg, rgba(7, 14, 25, 0.88) 0%, rgba(10, 18, 31, 0.62) 100%);- border-bottom: 1px solid rgba(112, 196, 255, 0.1);+ background: ${GRAPH_THEME.ui.surface.cardSubtle};+ border-bottom: 1px solid ${GRAPH_THEME.ui.surface.panelBorder};backdrop-filter: blur(12px);-webkit-backdrop-filter: blur(12px);}.glass-hud {- background: linear-gradient(135deg, rgba(8, 15, 27, 0.76), rgba(10, 19, 32, 0.58));+ background: ${GRAPH_THEME.ui.surface.panel};backdrop-filter: blur(14px) saturate(1.08);-webkit-backdrop-filter: blur(14px) saturate(1.08);- border-left: 1px solid rgba(112, 196, 255, 0.14);- box-shadow: -10px 0 28px rgba(0, 0, 0, 0.34), inset 1px 0 0 rgba(255, 255, 255, 0.04);+ border-left: 1px solid ${GRAPH_THEME.ui.surface.panelBorder};+ box-shadow: ${GRAPH_THEME.ui.surface.shadow};}.hud-scrollbar::-webkit-scrollbar { width: 6px; }.hud-scrollbar::-webkit-scrollbar-track { background: transparent; }- .hud-scrollbar::-webkit-scrollbar-thumb { background: rgba(88, 166, 255, 0.25); border-radius: 6px; }+ .hud-scrollbar::-webkit-scrollbar-thumb { background: rgba(215, 209, 196, 0.22); border-radius: 6px; }.node-panel-collapse {- border: 1px solid rgba(255, 255, 255, 0.05);+ border: 1px solid ${GRAPH_THEME.ui.surface.panelBorder};border-radius: 12px;- background: rgba(0, 0, 0, 0.14);+ background: rgba(255, 255, 255, 0.026);overflow: hidden;}.node-panel-collapse + .node-panel-collapse {@@ -184,7 +360,7 @@ const HUD_CSS = `justify-content: space-between;gap: 12px;padding: 12px 14px;- color: #c6d4e3;+ color: ${GRAPH_THEME.ui.text.body};font-size: 12px;font-weight: 700;letter-spacing: 0.04em;@@ -195,7 +371,7 @@ const HUD_CSS = `}.node-panel-summary::after {content: "+";- color: rgba(127, 208, 255, 0.8);+ color: ${GRAPH_THEME.ui.timeline.playhead};font-size: 16px;line-height: 1;}@@ -218,9 +394,9 @@ const HUD_CSS = `width: min(460px, calc(100% - 48px));border-radius: 20px;padding: 22px 22px 18px;- background: linear-gradient(135deg, rgba(7, 17, 31, 0.9), rgba(14, 28, 48, 0.78));- border: 1px solid rgba(127, 208, 255, 0.16);- box-shadow: 0 24px 80px rgba(0, 0, 0, 0.38), inset 0 1px 0 rgba(255,255,255,0.04);+ background: ${GRAPH_THEME.ui.surface.cardStrong};+ border: 1px solid ${GRAPH_THEME.ui.surface.panelBorder};+ box-shadow: ${GRAPH_THEME.ui.surface.shadow};backdrop-filter: blur(18px);-webkit-backdrop-filter: blur(18px);}@@ -233,8 +409,8 @@ const HUD_CSS = `width: 10px;height: 10px;border-radius: 999px;- background: linear-gradient(135deg, rgba(127, 208, 255, 0.96), rgba(242, 182, 109, 0.96));- box-shadow: 0 0 18px rgba(127, 208, 255, 0.35);+ background: linear-gradient(135deg, ${GRAPH_THEME.ui.timeline.playhead}, ${GRAPH_THEME.palette.accent.selected});+ box-shadow: 0 0 18px rgba(98, 226, 205, 0.28);animation: sem-loader-pulse 1.2s ease-in-out infinite;}.graph-loading-dot:nth-child(2) {@@ -258,15 +434,15 @@ const HUD_CSS = `height: 10px;border-radius: 999px;overflow: hidden;- background: rgba(255, 255, 255, 0.06);- border: 1px solid rgba(127, 208, 255, 0.1);+ background: rgba(255, 255, 255, 0.052);+ border: 1px solid ${GRAPH_THEME.ui.surface.panelBorder};}.graph-loading-bar > span {display: block;height: 100%;border-radius: 999px;- background: linear-gradient(90deg, rgba(74, 163, 255, 0.9), rgba(127, 208, 255, 0.95), rgba(242, 182, 109, 0.92));- box-shadow: 0 0 28px rgba(74, 163, 255, 0.3);+ background: linear-gradient(90deg, rgba(98, 226, 205, 0.9), rgba(233, 196, 122, 0.9));+ box-shadow: 0 0 28px rgba(98, 226, 205, 0.22);transition: width 180ms ease;}.explore-shell {@@ -316,6 +492,7 @@ const HUD_CSS = `flex: 1;overflow: hidden;border-radius: 20px 20px 0 0;+ background: ${GRAPH_THEME.ui.surface.stage};}.explore-scene-stage {position: relative;@@ -326,8 +503,8 @@ const HUD_CSS = `.explore-scene-footer {position: relative;z-index: 3;- border-top: 1px solid rgba(112, 196, 255, 0.1);- background: linear-gradient(180deg, rgba(5, 11, 20, 0.94), rgba(5, 11, 20, 0.82));+ border-top: 1px solid ${GRAPH_THEME.ui.timeline.border};+ background: ${GRAPH_THEME.ui.timeline.background};}.explore-plugin-dock {position: relative;@@ -340,9 +517,9 @@ const HUD_CSS = `flex-wrap: wrap;}.explore-plugin-dock-tab {- border: 1px solid rgba(127, 208, 255, 0.14);- background: rgba(255, 255, 255, 0.03);- color: #a9bfd7;+ border: 1px solid ${GRAPH_THEME.ui.control.defaultBorder};+ background: ${GRAPH_THEME.ui.control.defaultBg};+ color: ${GRAPH_THEME.ui.control.defaultText};border-radius: 999px;padding: 6px 10px;font-size: 11px;@@ -350,33 +527,219 @@ const HUD_CSS = `cursor: pointer;}.explore-plugin-dock-tab[data-active="true"] {- color: #eef6ff;- background: rgba(74, 163, 255, 0.16);- border-color: rgba(127, 208, 255, 0.28);+ color: ${GRAPH_THEME.ui.control.activeText};+ background: rgba(74, 181, 166, 0.18);+ border-color: ${GRAPH_THEME.ui.control.activeBorder};}.explore-toolbar {+ display: flex;+ flex-direction: column;+ gap: 12px;+ }+ .explore-status-strip {display: flex;align-items: center;- justify-content: space-between;- gap: 10px;+ gap: 7px;flex-wrap: wrap;}- .explore-toolbar-groups {+ .explore-workflow-bar {+ display: grid;+ grid-template-columns: minmax(280px, 1.1fr) auto minmax(360px, 1.55fr);+ align-items: center;+ gap: 10px;+ }+ .explore-search-command {+ min-width: 0;+ height: 43px;+ display: grid;+ grid-template-columns: auto minmax(0, 1fr) auto;+ align-items: center;+ gap: 9px;+ padding: 4px 5px 4px 13px;+ border-radius: 16px;+ border: 1px solid ${GRAPH_THEME.ui.control.inputBorder};+ background:+ linear-gradient(135deg, rgba(255,255,255,0.06), rgba(255,255,255,0.018)),+ ${GRAPH_THEME.ui.control.inputBg};+ color: ${GRAPH_THEME.ui.text.muted};+ box-shadow: inset 0 1px 0 rgba(255,255,255,0.045), 0 14px 30px rgba(0,0,0,0.16);+ }+ .explore-search-command:focus-within {+ border-color: ${GRAPH_THEME.ui.control.activeBorder};+ box-shadow: inset 0 1px 0 rgba(255,255,255,0.06), 0 0 0 1px ${GRAPH_THEME.ui.control.focusRing}, 0 16px 32px rgba(0,0,0,0.18);+ }+ .explore-search-command input {+ width: 100%;+ min-width: 0;+ border: 0;+ outline: 0;+ color: ${GRAPH_THEME.ui.text.strong};+ background: transparent;+ font-size: 13px;+ }+ .explore-search-command input::placeholder {+ color: ${GRAPH_THEME.ui.text.subtle};+ }+ .explore-search-command button {+ height: 33px;+ border: 1px solid ${GRAPH_THEME.ui.control.primaryBorder};+ border-radius: 12px;+ padding: 0 13px;+ background: ${GRAPH_THEME.ui.control.primaryBg};+ color: ${GRAPH_THEME.ui.control.primaryText};+ font-size: 12px;+ font-weight: 800;+ cursor: pointer;+ box-shadow: inset 0 1px 0 rgba(255,255,255,0.08);+ }+ .explore-search-command button:disabled {+ cursor: not-allowed;+ opacity: 0.45;+ }+ .explore-mode-control {+ display: inline-grid;+ grid-template-columns: repeat(3, minmax(88px, auto));+ align-items: center;+ padding: 4px;+ border-radius: 16px;+ border: 1px solid ${GRAPH_THEME.ui.control.defaultBorder};+ background: rgba(255, 255, 255, 0.026);+ box-shadow: inset 0 1px 0 rgba(255,255,255,0.035);+ }+ .explore-mode-segment {+ min-width: 0;+ border-radius: 12px;+ }+ .explore-toolbelt {+ min-width: 0;display: flex;+ justify-content: flex-end;align-items: center;gap: 8px;flex-wrap: wrap;- flex: 1;- justify-content: flex-end;}- .explore-toolbar-group {+ .explore-tool-cluster {display: inline-flex;align-items: center;- gap: 8px;- padding: 3px;- border-radius: 14px;- border: 1px solid rgba(127, 208, 255, 0.08);- background: rgba(255, 255, 255, 0.02);+ gap: 6px;+ min-height: 43px;+ padding: 4px;+ border-radius: 16px;+ border: 1px solid rgba(211, 205, 190, 0.075);+ background: rgba(255, 255, 255, 0.022);+ }+ .explore-tool-cluster-label {+ padding: 0 4px 0 7px;+ color: ${GRAPH_THEME.ui.text.subtle};+ font-size: 10px;+ font-weight: 800;+ letter-spacing: 0.08em;+ text-transform: uppercase;+ white-space: nowrap;+ }+ .explore-tool-cluster-items {+ display: inline-flex;+ align-items: center;+ gap: 4px;+ flex-wrap: wrap;+ }+ .explore-tool-button {+ min-height: 33px;+ display: inline-flex;+ align-items: center;+ justify-content: center;+ gap: 7px;+ border: 1px solid ${GRAPH_THEME.ui.control.defaultBorder};+ border-radius: 12px;+ padding: 7px 10px;+ background: ${GRAPH_THEME.ui.control.defaultBg};+ color: ${GRAPH_THEME.ui.control.defaultText};+ font-size: 12px;+ font-weight: 700;+ line-height: 1;+ cursor: pointer;+ white-space: nowrap;+ box-shadow: inset 0 1px 0 rgba(255,255,255,0.035);+ transition: background 140ms ease, border-color 140ms ease, color 140ms ease, transform 140ms ease;+ }+ .explore-tool-button:hover:not(:disabled) {+ background: ${GRAPH_THEME.ui.control.hoverBg};+ border-color: rgba(211, 205, 190, 0.18);+ transform: translateY(-1px);+ }+ .explore-tool-button:disabled {+ cursor: not-allowed;+ color: ${GRAPH_THEME.ui.control.disabledText};+ opacity: 0.48;+ transform: none;+ }+ .explore-tool-button[data-active="true"] {+ color: ${GRAPH_THEME.ui.control.activeText};+ background: ${GRAPH_THEME.ui.control.activeBg};+ border-color: ${GRAPH_THEME.ui.control.activeBorder};+ box-shadow: 0 0 0 1px ${GRAPH_THEME.ui.control.focusRing}, inset 0 1px 0 rgba(255,255,255,0.06);+ }+ .explore-tool-button-primary {+ color: ${GRAPH_THEME.ui.control.primaryText};+ background: ${GRAPH_THEME.ui.control.primaryBg};+ border-color: ${GRAPH_THEME.ui.control.primaryBorder};+ }+ .explore-tool-button[data-compact="true"] {+ min-width: 34px;+ padding-inline: 9px;+ }+ .explore-tool-button[data-compact="true"] .explore-tool-button-label {+ display: none;+ }+ .explore-entity-key {+ display: flex;+ align-items: center;+ gap: 10px;+ flex-wrap: wrap;+ padding: 2px 1px 0;+ color: ${GRAPH_THEME.ui.text.subtle};+ font-size: 10px;+ font-weight: 700;+ letter-spacing: 0.02em;+ }+ .explore-entity-key-item {+ display: inline-flex;+ align-items: center;+ gap: 6px;+ white-space: nowrap;+ }+ .explore-entity-key-mark {+ width: 13px;+ height: 13px;+ display: inline-block;+ border: 1px solid rgba(194, 214, 218, 0.42);+ background: rgba(73, 154, 150, 0.58);+ box-shadow: inset 0 1px 0 rgba(255,255,255,0.08);+ }+ .explore-entity-key-mark[data-shape="entity"] {+ border-radius: 999px;+ }+ .explore-entity-key-mark[data-shape="biomolecule"] {+ clip-path: polygon(50% 7%, 86% 28%, 86% 72%, 50% 93%, 14% 72%, 14% 28%);+ }+ .explore-entity-key-mark[data-shape="condition"] {+ border-radius: 5px;+ transform: rotate(45deg) scale(0.88);+ }+ .explore-entity-key-mark[data-shape="compound"] {+ width: 20px;+ border-radius: 999px;+ }+ .explore-entity-key-mark[data-shape="process"] {+ border-radius: 4px;+ clip-path: polygon(0 0, 86% 0, 100% 16%, 100% 100%, 0 100%);+ }+ .explore-entity-key-mark[data-shape="community"] {+ width: 15px;+ height: 15px;+ border-radius: 999px;+ background: rgba(96, 190, 180, 0.16);+ border-color: rgba(229, 213, 175, 0.54);}.explore-search-results {display: flex;@@ -404,6 +767,13 @@ const HUD_CSS = `.explore-main-grid {grid-template-columns: 1fr;}+ .explore-workflow-bar {+ grid-template-columns: minmax(280px, 1fr) auto;+ }+ .explore-toolbelt {+ grid-column: 1 / -1;+ justify-content: flex-start;+ }}@media (max-width: 980px) {.explore-shell {@@ -413,6 +783,19 @@ const HUD_CSS = `.explore-command-grid {grid-template-columns: 1fr;}+ .explore-workflow-bar {+ grid-template-columns: 1fr;+ }+ .explore-mode-control {+ width: 100%;+ grid-template-columns: repeat(3, minmax(0, 1fr));+ }+ .explore-toolbelt {+ justify-content: flex-start;+ }+ .explore-tool-cluster {+ max-width: 100%;+ }}`;@@ -713,7 +1096,7 @@ export function GraphWorkspace() {const [activeDockPanelId, setActiveDockPanelId] = useState<string | null>(null);const [pluginRuntimeVersion, setPluginRuntimeVersion] = useState(0);const [effectsState, setEffectsState] = useState<GraphEffectsState>(DEFAULT_EFFECTS_STATE);- const [graphDiagnosticsState, setGraphDiagnosticsState] = useState<GraphDiagnosticsSnapshot["effectAvailability"] | null>(null);+ const [graphDiagnosticsState, setGraphDiagnosticsState] = useState<GraphRuntimeDiagnosticsSnapshot | null>(null);const [graphAnalyticsState, setGraphAnalyticsState] = useState<GraphAnalyticsSnapshot | null>(null);const [loadedPlugins, setLoadedPlugins] = useState<Record<string, GraphPlugin>>({});@@ -993,6 +1376,11 @@ export function GraphWorkspace() {const focusNode = useCallback((nodeId: string) => {if (!nodeId) {+ setSelectedNodeId("");+ setSelectedEdgeId("");+ setPathResult(null);+ setSearchResults([]);+ setSearchError("");return;}@@ -1486,7 +1874,8 @@ export function GraphWorkspace() {.filter(([, isOpen]) => isOpen).map(([panelId]) => panelId),effectsState,- effectAvailability: graphDiagnosticsState,+ edgeClasses: graphDiagnosticsState.edgeClasses,+ effectAvailability: graphDiagnosticsState.effectAvailability,};}, [activePlugins, effectsState, graphDiagnosticsState, pluginPanelState]);@@ -1547,11 +1936,11 @@ export function GraphWorkspace() {}}, [activePlugins, pluginContext]);- const handleDiagnosticsChange = useCallback((effectAvailability: GraphDiagnosticsSnapshot["effectAvailability"]) => {+ const handleDiagnosticsChange = useCallback((diagnostics: GraphRuntimeDiagnosticsSnapshot) => {if (!GRAPH_THEME.effects.diagnostics.enabledInDev) {return;}- setGraphDiagnosticsState(effectAvailability);+ setGraphDiagnosticsState(diagnostics);}, []);const handleAnalyticsChange = useCallback((analytics: GraphAnalyticsSnapshot | null) => {@@ -1639,146 +2028,181 @@ export function GraphWorkspace() {}}, [activeDockPanelId, openDockPanels]);- const coreToolbarGroups = useMemo<GraphToolbarGroup[]>(() => {- const groups: GraphToolbarGroup[] = [];-- if (hasGraphContent) {- groups.push({- id: "view-mode",- items: [- {- id: "view-full",- label: "Full Graph",- title: "Return to the full graph context",- active: viewMode === "full",- onClick: () => requestViewMode("full"),- },- {- id: "view-grouped",- label: "Grouped View",- title: displayState.groupedViewAvailable- ? "Compress dense structure into detected communities"- : (displayState.groupedViewReason ?? "Grouped view is unavailable until communities can be detected"),- active: viewMode === "grouped",- disabled: !displayState.groupedViewAvailable,- onClick: () => requestViewMode("grouped"),- },- {- id: "view-focused",- label: "Focused",- title: canActivateFocusedMode- ? "Inspect the selected node in a focused local graph"- : (focusedSelectionResolution.reason ?? "Focused mode is unavailable for the current selection"),- active: viewMode === "focused",- disabled: viewMode !== "focused" && !canActivateFocusedMode,- onClick: () => requestViewMode("focused"),- },- ],- });- }-- if (selectedNodeState) {- groups.push({- id: "local-structure",- items: [- {- id: "collapse-neighborhood",- label: "Collapse Neighborhood",- title: "Hide lower-priority fanout around the selected node",- disabled: !selectedNodeState.canCollapseNeighborhood || selectedNodeState.isNeighborhoodCollapsed,- onClick: () => handlePluginAction({ type: "collapseNeighborhood" }),- },- {- id: "expand-neighborhood",- label: "Expand Neighborhood",- title: "Restore the collapsed local neighborhood",- disabled: !selectedNodeState.isNeighborhoodCollapsed,- onClick: () => handlePluginAction({ type: "expandNeighborhood" }),- },- ],- });- }-- groups.push({- id: "graph-actions",- items: [- {- id: "search-submit",- label: "Search",- title: "Search for the current query",- tone: "primary",- disabled: showLoadingOverlay || !searchQuery.trim(),- onClick: () => void handleSearch(),- },- {- id: "zoom-in",- label: "+ Zoom In",- title: "Zoom in (or scroll up on the canvas)",- onClick: () => sceneRef.current?.zoomIn(),- },- {- id: "zoom-out",- label: "- Zoom Out",- title: "Zoom out (or scroll down on the canvas)",- onClick: () => sceneRef.current?.zoomOut(),- },- {- id: "fit-view",- label: "Fit View",- title: "Reset the camera to fit the whole graph",- onClick: () => sceneRef.current?.fitView(),- },- {- id: "layout-toggle",- label: isLayoutRunning ? "Pause Layout" : "Run Layout",- title: "Toggle the layout worker",- active: isLayoutRunning,- disabled: showLoadingOverlay,- onClick: () => setIsLayoutRunning((value) => !value),- },- {- id: "reload",- label: "Reload",- title: "Reload the graph data",- disabled: showLoadingOverlay,- onClick: reload,- },- ],- });-- if (pluginToolbarItems.length) {- groups.push({- id: "plugin-tools",- items: pluginToolbarItems.map((item) => ({- id: item.id,- label: item.label,- title: item.title,- active: item.active,- onClick: item.onClick,- })),- });+ const viewModeItems = useMemo<GraphToolbarItem[]>(() => {+ if (!hasGraphContent) {+ return [];}- return groups;+ return [+ {+ id: "view-full",+ label: "Full Graph",+ title: "Return to the full graph context",+ icon: Layers3,+ active: viewMode === "full",+ onClick: () => requestViewMode("full"),+ },+ {+ id: "view-grouped",+ label: "Grouped View",+ title: displayState.groupedViewAvailable+ ? "Compress dense structure into detected communities"+ : (displayState.groupedViewReason ?? "Grouped view is unavailable until communities can be detected"),+ icon: GitBranch,+ active: viewMode === "grouped",+ disabled: !displayState.groupedViewAvailable,+ onClick: () => requestViewMode("grouped"),+ },+ {+ id: "view-focused",+ label: "Focused",+ title: canActivateFocusedMode+ ? "Inspect the selected node in a focused local graph"+ : (focusedSelectionResolution.reason ?? "Focused mode is unavailable for the current selection"),+ icon: Focus,+ active: viewMode === "focused",+ disabled: viewMode !== "focused" && !canActivateFocusedMode,+ onClick: () => requestViewMode("focused"),+ },+ ];}, [canActivateFocusedMode,displayState.groupedViewAvailable,displayState.groupedViewReason,- handlePluginAction,hasGraphContent,- isLayoutRunning,- pluginToolbarItems,- reload,requestViewMode,- searchQuery,- canActivateFocusedMode,focusedSelectionResolution.reason,- selectedNodeId,- selectedNodeState,- showLoadingOverlay,viewMode,]);+ const cameraToolbarItems = useMemo<GraphToolbarItem[]>(() => [+ {+ id: "zoom-in",+ label: "Zoom In",+ title: "Zoom in (or scroll up on the canvas)",+ ariaLabel: "Zoom in",+ icon: ZoomIn,+ compact: true,+ onClick: () => sceneRef.current?.zoomIn(),+ },+ {+ id: "zoom-out",+ label: "Zoom Out",+ title: "Zoom out (or scroll down on the canvas)",+ ariaLabel: "Zoom out",+ icon: ZoomOut,+ compact: true,+ onClick: () => sceneRef.current?.zoomOut(),+ },+ {+ id: "fit-view",+ label: "Fit",+ title: "Reset the camera to fit the whole graph",+ ariaLabel: "Fit view",+ icon: Maximize2,+ compact: true,+ onClick: () => sceneRef.current?.fitView(),+ },+ ], []);++ const layoutToolbarItems = useMemo<GraphToolbarItem[]>(() => [+ {+ id: "layout-toggle",+ label: isLayoutRunning ? "Pause" : "Run",+ title: "Toggle the layout worker",+ icon: isLayoutRunning ? Pause : Play,+ active: isLayoutRunning,+ disabled: showLoadingOverlay,+ onClick: () => setIsLayoutRunning((value) => !value),+ },+ ], [isLayoutRunning, showLoadingOverlay]);++ const localToolbarItems = useMemo<GraphToolbarItem[]>(() => {+ if (!selectedNodeState) {+ return [];+ }++ return [+ {+ id: "collapse-neighborhood",+ label: "Collapse",+ title: "Hide lower-priority fanout around the selected node",+ icon: Eye,+ disabled: !selectedNodeState.canCollapseNeighborhood || selectedNodeState.isNeighborhoodCollapsed,+ onClick: () => handlePluginAction({ type: "collapseNeighborhood" }),+ },+ {+ id: "expand-neighborhood",+ label: "Expand",+ title: "Restore the collapsed local neighborhood",+ icon: Users,+ disabled: !selectedNodeState.isNeighborhoodCollapsed,+ onClick: () => handlePluginAction({ type: "expandNeighborhood" }),+ },+ ];+ }, [handlePluginAction, selectedNodeState]);++ const analysisToolbarItems = useMemo<GraphToolbarItem[]>(+ () => pluginToolbarItems.map((item) => ({+ id: item.id,+ label: item.label,+ title: item.title,+ icon: iconForPluginToolbarItem(item),+ active: item.active,+ onClick: item.onClick,+ })),+ [pluginToolbarItems],+ );++ const utilityToolbarItems = useMemo<GraphToolbarItem[]>(() => [+ {+ id: "reload",+ label: "Reload",+ title: "Reload the graph data",+ ariaLabel: "Reload graph data",+ icon: RefreshCw,+ compact: true,+ disabled: showLoadingOverlay,+ onClick: reload,+ },+ ], [reload, showLoadingOverlay]);++ const searchDisabled = showLoadingOverlay || !searchQuery.trim();++ const toolbarClusters = useMemo<GraphToolbarGroup[]>(() => [+ {+ id: "camera",+ label: "Camera",+ items: cameraToolbarItems,+ },+ {+ id: "layout",+ label: "Layout",+ items: layoutToolbarItems,+ },+ {+ id: "local-structure",+ label: "Local",+ items: localToolbarItems,+ },+ {+ id: "analysis",+ label: "Analysis",+ items: analysisToolbarItems,+ },+ {+ id: "utility",+ label: "Utility",+ items: utilityToolbarItems,+ },+ ].filter((group) => group.items.length > 0), [+ analysisToolbarItems,+ cameraToolbarItems,+ layoutToolbarItems,+ localToolbarItems,+ utilityToolbarItems,+ ]);+const sceneAdapterProps = {onNodeSelect: focusNode,onEdgeSelect: handleEdgeSelect,@@ -1816,7 +2240,7 @@ export function GraphWorkspace() {<SurfaceCard tone="subtle"><div style={{ display: "flex", flexDirection: "column", gap: 12 }}><div className="explore-toolbar">- <div style={{ display: "flex", gap: 8, flexWrap: "wrap", alignItems: "center" }}>+ <div className="explore-status-strip">{(showLoadingOverlay || showSettlingStatus) && loadingProgress ? (<MetricChip>{getGraphLoadTitle(loadingProgress.phase)}</MetricChip>) : null}@@ -1828,51 +2252,26 @@ export function GraphWorkspace() {) : null}{focusedSummary ? <MetricChip tone="warm">{focusedSummary}</MetricChip> : null}</div>- <div className="explore-toolbar-groups">- <div style={{ minWidth: 280, flex: "1 1 320px" }}>- <input- value={searchQuery}- onChange={(event) => setSearchQuery(event.target.value)}- onKeyDown={(event) => {- if (event.key === "Enter") {- void handleSearch();- }- }}- placeholder="Search a node, e.g. Metformin"- style={{ ...inputStyle, margin: 0, minHeight: 38 }}- />+ <div className="explore-workflow-bar">+ <SearchCommandBar+ value={searchQuery}+ disabled={searchDisabled}+ onChange={setSearchQuery}+ onSubmit={() => void handleSearch()}+ />+ <SegmentedModeControl items={viewModeItems} />+ <div className="explore-toolbelt">+ {toolbarClusters.map((group) => (+ <ToolbarCluster+ key={group.id}+ label={group.label ?? group.id}+ items={group.items}+ compact={COMPACT_TOOLBAR_CLUSTER_IDS.has(group.id)}+ />+ ))}</div>- {coreToolbarGroups.map((group) => (- <div key={group.id} className="explore-toolbar-group">- {group.items.map((item) => {- const baseStyle = item.tone === "primary" ? actionButtonStyle : secondaryActionButtonStyle;- return (- <button- key={item.id}- onClick={item.onClick}- title={item.title}- disabled={item.disabled}- style={{- ...baseStyle,- minHeight: 36,- padding: "8px 12px",- background: item.active- ? "rgba(31, 111, 235, 0.28)"- : baseStyle.background,- border: item.active- ? "1px solid rgba(127, 208, 255, 0.35)"- : baseStyle.border,- color: item.active ? "#e6f2ff" : baseStyle.color,- boxShadow: item.active ? `0 0 0 1px rgba(127, 208, 255, 0.12)` : baseStyle.boxShadow,- }}- >- {item.label}- </button>- );- })}- </div>- ))}</div>+ <EntityVisualKey /></div>{searchError ? <div style={{ color: "#ff7b72", fontSize: 12 }}>{searchError}</div> : null}@@ -2068,21 +2467,10 @@ export function GraphWorkspace() {);}-const inputStyle: React.CSSProperties = {- width: "100%",- background: "rgba(4, 10, 18, 0.5)",- border: `1px solid ${GRAPH_THEME.palette.background.shellBorder}`,- color: "#edf5ff",- borderRadius: 12,- padding: "11px 13px",- fontSize: 13,- boxShadow: "inset 0 1px 0 rgba(255,255,255,0.03)",-};-const actionButtonStyle: React.CSSProperties = {- background: "linear-gradient(135deg, rgba(24, 63, 133, 0.42), rgba(35, 85, 176, 0.28))",- color: "#fff",- border: `1px solid ${GRAPH_THEME.palette.background.shellBorder}`,+ background: GRAPH_THEME.ui.control.primaryBg,+ color: GRAPH_THEME.ui.control.primaryText,+ border: `1px solid ${GRAPH_THEME.ui.control.primaryBorder}`,borderRadius: 12,padding: "9px 12px",cursor: "pointer",@@ -2091,22 +2479,22 @@ const actionButtonStyle: React.CSSProperties = {display: "inline-flex",alignItems: "center",justifyContent: "center",- boxShadow: `0 8px 22px ${GRAPH_THEME.palette.background.shellGlow}`,+ boxShadow: "inset 0 1px 0 rgba(255,255,255,0.07), 0 10px 24px rgba(0,0,0,0.18)",};const secondaryActionButtonStyle: React.CSSProperties = {...actionButtonStyle,- background: "rgba(255, 255, 255, 0.03)",- border: "1px solid rgba(255, 255, 255, 0.08)",- color: "#c6d4e3",+ background: GRAPH_THEME.ui.control.defaultBg,+ border: `1px solid ${GRAPH_THEME.ui.control.defaultBorder}`,+ color: GRAPH_THEME.ui.control.defaultText,fontWeight: 600,};const predictionCardStyle: React.CSSProperties = {textAlign: "left",padding: 12,- background: "rgba(88, 166, 255, 0.08)",- border: "1px solid rgba(88, 166, 255, 0.12)",+ background: "rgba(255, 255, 255, 0.035)",+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,borderRadius: 10,cursor: "pointer",};@@ -2116,8 +2504,8 @@ const selectedEdgeCardStyle: React.CSSProperties = {flexDirection: "column",gap: 12,padding: 14,- background: "linear-gradient(135deg, rgba(88, 166, 255, 0.1), rgba(88, 166, 255, 0.04))",- border: "1px solid rgba(127, 208, 255, 0.16)",+ background: "linear-gradient(135deg, rgba(98, 226, 205, 0.1), rgba(233, 196, 122, 0.045))",+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,borderRadius: 14,boxShadow: "inset 0 1px 0 rgba(255,255,255,0.03)",};@@ -2139,18 +2527,18 @@ const selectedEdgePropertyCardStyle: React.CSSProperties = {borderRadius: 10,padding: 10,background: "rgba(255, 255, 255, 0.03)",- border: "1px solid rgba(255, 255, 255, 0.06)",+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,};const pluginDockContentStyle: React.CSSProperties = {borderRadius: 16,- border: "1px solid rgba(255, 255, 255, 0.06)",+ border: `1px solid ${GRAPH_THEME.ui.surface.panelBorder}`,background: "rgba(255, 255, 255, 0.02)",padding: 14,};const pluginLoadingStyle: React.CSSProperties = {- color: "#8ea4be",+ color: GRAPH_THEME.ui.text.muted,fontSize: 12,padding: 10,};@@ -2165,7 +2553,7 @@ const searchResultsStripStyle: React.CSSProperties = {const inspectorFallbackStyle: React.CSSProperties = {padding: 24,- color: "#8ea4be",+ color: GRAPH_THEME.ui.text.muted,fontSize: 12,};@@ -2174,8 +2562,8 @@ const timelineFallbackStyle: React.CSSProperties = {display: "flex",alignItems: "center",padding: "0 18px",- color: "#8ea4be",+ color: GRAPH_THEME.ui.text.muted,fontSize: 12,- borderTop: "1px solid rgba(88, 166, 255, 0.2)",- background: "rgba(1, 4, 9, 0.88)",+ borderTop: `1px solid ${GRAPH_THEME.ui.timeline.border}`,+ background: GRAPH_THEME.ui.timeline.background,};diff --git a/explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsx b/explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsxindex adb9a2a7..6535c2f3 100644--- a/explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsx+++ b/explorer/src/workspaces/GraphWorkspace/TimelinePanel.tsx@@ -3,6 +3,7 @@ import { DataSet } from "vis-data";import { Timeline } from "vis-timeline";import type { TimelineOptions } from "vis-timeline";import "vis-timeline/styles/vis-timeline-graph2d.css";+import { GRAPH_THEME } from "./graphTheme";export interface TimelinePanelProps {onTimeChange: (time: Date) => void;@@ -19,35 +20,35 @@ const PLAY_STEP_MONTHS = 6;const VIS_OVERRIDE_CSS = `.sem-timeline-wrap .vis-timeline { border: none !important; background: transparent !important; overflow: visible !important; }.sem-timeline-wrap .vis-panel.vis-background, .sem-timeline-wrap .vis-panel.vis-center { background: transparent !important; }- .sem-timeline-wrap .vis-panel { border-color: rgba(88, 166, 255, 0.15) !important; }+ .sem-timeline-wrap .vis-panel { border-color: ${GRAPH_THEME.ui.timeline.border} !important; }.sem-timeline-wrap .vis-time-axis .vis-text {- color: #8b949e !important;+ color: ${GRAPH_THEME.ui.timeline.text} !important;font-size: 11px !important;font-family: 'JetBrains Mono', 'Fira Code', monospace !important;padding-top: 3px !important;}.sem-timeline-wrap .vis-time-axis .vis-text.vis-major {- color: #c9d1d9 !important;+ color: ${GRAPH_THEME.ui.timeline.textStrong} !important;font-weight: 700 !important;font-size: 12px !important;}- .sem-timeline-wrap .vis-time-axis .vis-grid.vis-minor { border-color: rgba(88, 166, 255, 0.07) !important; }- .sem-timeline-wrap .vis-time-axis .vis-grid.vis-major { border-color: rgba(88, 166, 255, 0.18) !important; }+ .sem-timeline-wrap .vis-time-axis .vis-grid.vis-minor { border-color: ${GRAPH_THEME.ui.timeline.gridMinor} !important; }+ .sem-timeline-wrap .vis-time-axis .vis-grid.vis-major { border-color: ${GRAPH_THEME.ui.timeline.gridMajor} !important; }.sem-timeline-wrap .vis-custom-time.${PLAYHEAD_ID} {- background: rgba(88, 166, 255, 0.15) !important;+ background: ${GRAPH_THEME.ui.timeline.playheadSoft} !important;width: 2px !important;cursor: ew-resize !important;z-index: 5 !important;}.sem-timeline-wrap .vis-custom-time.${PLAYHEAD_ID} > .vis-custom-time-marker {- background: #58a6ff !important;- color: #0d1117 !important;+ background: ${GRAPH_THEME.ui.timeline.playhead} !important;+ color: ${GRAPH_THEME.ui.text.inverse} !important;font-size: 10px !important;font-weight: 700 !important;border-radius: 3px !important;padding: 1px 5px !important;white-space: nowrap !important;- box-shadow: 0 0 8px rgba(88, 166, 255, 0.7) !important;+ box-shadow: 0 0 8px rgba(98, 226, 205, 0.45) !important;}.sem-timeline-wrap .vis-current-time { display: none !important; }.sem-timeline-wrap .vis-panel.vis-left { display: none !important; }@@ -166,14 +167,14 @@ export function TimelinePanel({ onTimeChange, minDate, maxDate }: TimelinePanelPuseEffect(() => () => stopPlay(), [stopPlay]);return (- <div style={{ position: "relative", width: "100%", height: "90px", borderTop: "1px solid rgba(88, 166, 255, 0.2)", background: "rgba(1, 4, 9, 0.88)", backdropFilter: "blur(16px)", WebkitBackdropFilter: "blur(16px)", display: "flex", alignItems: "stretch", flexShrink: 0 }}>+ <div style={{ position: "relative", width: "100%", height: "90px", borderTop: `1px solid ${GRAPH_THEME.ui.timeline.border}`, background: GRAPH_THEME.ui.timeline.background, backdropFilter: "blur(16px)", WebkitBackdropFilter: "blur(16px)", display: "flex", alignItems: "stretch", flexShrink: 0 }}><style>{VIS_OVERRIDE_CSS}</style>- <div style={{ display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", gap: 4, padding: "0 16px", borderRight: "1px solid rgba(88, 166, 255, 0.15)", minWidth: 80, flexShrink: 0 }}>+ <div style={{ display: "flex", flexDirection: "column", alignItems: "center", justifyContent: "center", gap: 4, padding: "0 16px", borderRight: `1px solid ${GRAPH_THEME.ui.timeline.border}`, minWidth: 80, flexShrink: 0 }}><buttonid="temporal-play-btn"onClick={togglePlay}title={isPlaying ? "Pause Evolution" : "Play Evolution"}- style={{ width: 34, height: 34, borderRadius: "50%", border: `1.5px solid ${isPlaying ? "#58a6ff" : "rgba(88, 166, 255, 0.35)"}`, background: isPlaying ? "rgba(88, 166, 255, 0.2)" : "rgba(88, 166, 255, 0.06)", color: "#58a6ff", cursor: "pointer", display: "flex", alignItems: "center", justifyContent: "center", transition: "all 0.2s", boxShadow: isPlaying ? "0 0 10px rgba(88, 166, 255, 0.4)" : "none" }}+ style={{ width: 34, height: 34, borderRadius: "50%", border: `1.5px solid ${isPlaying ? GRAPH_THEME.ui.control.activeBorder : GRAPH_THEME.ui.control.defaultBorder}`, background: isPlaying ? GRAPH_THEME.ui.timeline.playheadSoft : GRAPH_THEME.ui.control.defaultBg, color: GRAPH_THEME.ui.timeline.playhead, cursor: "pointer", display: "flex", alignItems: "center", justifyContent: "center", transition: "all 0.2s", boxShadow: isPlaying ? "0 0 10px rgba(98, 226, 205, 0.32)" : "none" }}>{isPlaying ? (<svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor"><rect x="6" y="4" width="4" height="16" /><rect x="14" y="4" width="4" height="16" /></svg>@@ -181,12 +182,12 @@ export function TimelinePanel({ onTimeChange, minDate, maxDate }: TimelinePanelP<svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor"><polygon points="5,3 19,12 5,21" /></svg>)}</button>- <span style={{ fontSize: 10, color: isPlaying ? "#58a6ff" : "#8b949e", fontFamily: "monospace", letterSpacing: "0.04em", transition: "color 0.2s" }}>+ <span style={{ fontSize: 10, color: isPlaying ? GRAPH_THEME.ui.timeline.playhead : GRAPH_THEME.ui.timeline.text, fontFamily: "monospace", letterSpacing: "0.04em", transition: "color 0.2s" }}>{displayDate}</span></div>- <div style={{ position: "absolute", top: 5, left: 100, fontSize: 10, fontWeight: 600, letterSpacing: "0.1em", color: "rgba(88, 166, 255, 0.55)", textTransform: "uppercase", pointerEvents: "none", zIndex: 2 }}>+ <div style={{ position: "absolute", top: 5, left: 100, fontSize: 10, fontWeight: 600, letterSpacing: "0.1em", color: GRAPH_THEME.ui.text.subtle, textTransform: "uppercase", pointerEvents: "none", zIndex: 2 }}>Temporal Scrubber · {minBound.getFullYear()}-{maxBound.getFullYear()}</div>diff --git a/explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.ts b/explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.tsindex 16342480..369e06c2 100644--- a/explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.ts+++ b/explorer/src/workspaces/GraphWorkspace/behaviors/clickSelectionBehavior.ts@@ -7,11 +7,19 @@ export const clickSelectionBehavior: GraphBehavior = {onNodeClick: (context, nodeId) => {context.setHoveredNodeId(nodeId);context.onEdgeSelectionChange("");- context.onNodeSelectionChange(nodeId);+ if (context.getInteractionState().selectedNodeId === nodeId) {+ context.onNodeSelectionChange("");+ } else {+ context.onNodeSelectionChange(nodeId);+ }},onEdgeClick: (context, edgeId) => {context.setHoveredNodeId(null);- context.onEdgeSelectionChange(edgeId);+ if (context.getInteractionState().selectedEdgeId === edgeId) {+ context.onEdgeSelectionChange("");+ } else {+ context.onEdgeSelectionChange(edgeId);+ }},onStageClick: (context) => {context.setHoveredNodeId(null);diff --git a/explorer/src/workspaces/GraphWorkspace/graphAnalytics.ts b/explorer/src/workspaces/GraphWorkspace/graphAnalytics.tsindex 72a6f9de..2505cdab 100644--- a/explorer/src/workspaces/GraphWorkspace/graphAnalytics.ts+++ b/explorer/src/workspaces/GraphWorkspace/graphAnalytics.ts@@ -44,8 +44,18 @@ const MAX_REGION_SUMMARIES = 6;const MAX_CENTRALITY_SUMMARIES = 6;const CENTRALITY_ITERATIONS = 24;const MAX_BACKBONE_ANCHORS = 4;-const MAX_BACKBONE_CENTRAL_LINKS = 2;-const MAX_BACKBONE_BRIDGES = 4;+const MAX_BACKBONE_CENTRAL_LINKS = 36;+const MAX_BACKBONE_BRIDGES = 80;+const MAX_BACKBONE_TOTAL_EDGES = 128;+const MAX_BACKBONE_EDGES_PER_NODE = 5;+const MAX_BACKBONE_PARALLEL_PAIR_EDGES = 2;++type BackboneCandidate = {+ edgeId: string;+ source: string;+ target: string;+ score: number;+};function getNodeLabel(graphRef: GraphRef, nodeId: string): string {const attrs = graphRef.getNodeAttributes(nodeId) as NodeAttributes;@@ -364,6 +374,61 @@ function scoreBackboneEdge(return weight * 1.4 + (sourceScore + targetScore) * 2.4 + priority * 0.6 + parallelBoost + bidirectionalBoost;}+function upsertBackboneCandidate(+ candidates: Map<string, BackboneCandidate>,+ key: string,+ candidate: BackboneCandidate,+) {+ const current = candidates.get(key);+ if (+ !current+ || candidate.score > current.score+ || (candidate.score === current.score && candidate.edgeId.localeCompare(current.edgeId) < 0)+ ) {+ candidates.set(key, candidate);+ }+}++function addRankedBackboneCandidates(+ selected: BackboneCandidate[],+ selectedEdgeIds: Set<string>,+ nodeUseCounts: Map<string, number>,+ pairUseCounts: Map<string, number>,+ candidates: Iterable<BackboneCandidate>,+ maxToAdd: number,+) {+ const ranked = [...candidates].sort((left, right) => {+ if (right.score !== left.score) {+ return right.score - left.score;+ }+ return left.edgeId.localeCompare(right.edgeId);+ });++ for (const candidate of ranked) {+ if (selected.length >= MAX_BACKBONE_TOTAL_EDGES || maxToAdd <= 0 || selectedEdgeIds.has(candidate.edgeId)) {+ continue;+ }++ const pairKey = [candidate.source, candidate.target].sort().join("::");+ if ((nodeUseCounts.get(candidate.source) ?? 0) >= MAX_BACKBONE_EDGES_PER_NODE) {+ continue;+ }+ if ((nodeUseCounts.get(candidate.target) ?? 0) >= MAX_BACKBONE_EDGES_PER_NODE) {+ continue;+ }+ if ((pairUseCounts.get(pairKey) ?? 0) >= MAX_BACKBONE_PARALLEL_PAIR_EDGES) {+ continue;+ }++ selected.push(candidate);+ selectedEdgeIds.add(candidate.edgeId);+ nodeUseCounts.set(candidate.source, (nodeUseCounts.get(candidate.source) ?? 0) + 1);+ nodeUseCounts.set(candidate.target, (nodeUseCounts.get(candidate.target) ?? 0) + 1);+ pairUseCounts.set(pairKey, (pairUseCounts.get(pairKey) ?? 0) + 1);+ maxToAdd -= 1;+ }+}+function buildOverviewBackboneSnapshot(graphRef: GraphRef,visibleNodeIds: Set<string>,@@ -379,7 +444,10 @@ function buildOverviewBackboneSnapshot(};}+ const selected: BackboneCandidate[] = [];const selectedEdgeIds = new Set<string>();+ const nodeUseCounts = new Map<string, number>();+ const pairUseCounts = new Map<string, number>();const regionByNode = new Map<string, string>();visibleNodeIds.forEach((nodeId) => {regionByNode.set(nodeId, getNodeSemanticGroup(graphRef, nodeId));@@ -397,7 +465,7 @@ function buildOverviewBackboneSnapshot(.map((summary) => summary.id).filter((nodeId) => visibleNodeIds.has(nodeId));- const coreLinkCandidates = new Map<string, { edgeId: string; score: number }>();+ const coreLinkCandidates = new Map<string, BackboneCandidate>();anchorIds.forEach((anchorId) => {collectNodeIncidentEdges(graphRef, anchorId, visibleNodeIds).filter((entry) => {@@ -415,60 +483,88 @@ function buildOverviewBackboneSnapshot(const targetRegion = regionByNode.get(entry.target);const bridgeBoost = sourceRegion && targetRegion && sourceRegion !== targetRegion ? 0.28 : 0;const score = scoreBackboneEdge(entry.attrs, entry.source, entry.target, base) + bridgeBoost;- const current = coreLinkCandidates.get(pairKey);- if (!current || score > current.score || (score === current.score && entry.edgeId.localeCompare(current.edgeId) < 0)) {- coreLinkCandidates.set(pairKey, { edgeId: entry.edgeId, score });- }+ upsertBackboneCandidate(coreLinkCandidates, pairKey, {+ edgeId: entry.edgeId,+ source: entry.source,+ target: entry.target,+ score,+ });});});- const bridgeByPair = new Map<string, { edgeId: string; score: number }>();+ const bridgeCandidates = new Map<string, BackboneCandidate>();+ const structuralCandidates = new Map<string, BackboneCandidate>();graphRef.forEachEdge((edgeId, attrs, source, target) => {if (!visibleNodeIds.has(source) || !visibleNodeIds.has(target)) {return;}- const sourceRegion = regionByNode.get(source);- const targetRegion = regionByNode.get(target);- if (!sourceRegion || !targetRegion || sourceRegion === targetRegion) {- return;- }+ const edgeKey = String(edgeId);+ const sourceId = String(source);+ const targetId = String(target);+ const sourceRegion = regionByNode.get(sourceId);+ const targetRegion = regionByNode.get(targetId);+ const sourceCommunity = base.communitiesByNode.get(sourceId);+ const targetCommunity = base.communitiesByNode.get(targetId);+ const crossesSemanticRegion = Boolean(sourceRegion && targetRegion && sourceRegion !== targetRegion);+ const crossesCommunity = sourceCommunity !== undefined && targetCommunity !== undefined && sourceCommunity !== targetCommunity;+ const sourceCentrality = base.centralityByNode.get(sourceId)?.score ?? 0;+ const targetCentrality = base.centralityByNode.get(targetId)?.score ?? 0;++ const baseScore = scoreBackboneEdge(attrs as EdgeAttributes, sourceId, targetId, base);+ const semanticBoost = crossesSemanticRegion ? 0.5 : 0;+ const communityBoost = crossesCommunity ? 0.36 : 0;+ const topRegionBoost = sourceRegion && targetRegion && (topRegionIds.has(sourceRegion) || topRegionIds.has(targetRegion)) ? 0.32 : 0;+ const centralityBalance = Math.min(sourceCentrality, targetCentrality) * 1.2;+ const score = baseScore + semanticBoost + communityBoost + topRegionBoost + centralityBalance;+ const candidate = {+ edgeId: edgeKey,+ source: sourceId,+ target: targetId,+ score,+ };- if (!topRegionIds.has(sourceRegion) && !topRegionIds.has(targetRegion)) {- return;+ if (crossesSemanticRegion || crossesCommunity) {+ const bridgeKey = [+ sourceRegion ?? `community:${sourceCommunity ?? sourceId}`,+ targetRegion ?? `community:${targetCommunity ?? targetId}`,+ Math.min(sourceCentrality, targetCentrality).toFixed(4),+ ].sort().join("::");+ upsertBackboneCandidate(bridgeCandidates, bridgeKey, candidate);}- const pairKey = [sourceRegion, targetRegion].sort().join("::");- const score = scoreBackboneEdge(attrs as EdgeAttributes, source, target, base) + 0.36;- const current = bridgeByPair.get(pairKey);- if (!current || score > current.score || (score === current.score && String(edgeId).localeCompare(current.edgeId) < 0)) {- bridgeByPair.set(pairKey, { edgeId: String(edgeId), score });- }+ const pairKey = [sourceId, targetId].sort().join("::");+ upsertBackboneCandidate(structuralCandidates, pairKey, candidate);});- [...bridgeByPair.values()]- .sort((left, right) => {- if (right.score !== left.score) {- return right.score - left.score;- }- return left.edgeId.localeCompare(right.edgeId);- })- .slice(0, MAX_BACKBONE_BRIDGES)- .forEach((entry) => selectedEdgeIds.add(entry.edgeId));-- [...coreLinkCandidates.values()]- .sort((left, right) => {- if (right.score !== left.score) {- return right.score - left.score;- }- return left.edgeId.localeCompare(right.edgeId);- })- .slice(0, MAX_BACKBONE_CENTRAL_LINKS)- .forEach((entry) => selectedEdgeIds.add(entry.edgeId));+ addRankedBackboneCandidates(+ selected,+ selectedEdgeIds,+ nodeUseCounts,+ pairUseCounts,+ bridgeCandidates.values(),+ MAX_BACKBONE_BRIDGES,+ );+ addRankedBackboneCandidates(+ selected,+ selectedEdgeIds,+ nodeUseCounts,+ pairUseCounts,+ coreLinkCandidates.values(),+ MAX_BACKBONE_CENTRAL_LINKS,+ );+ addRankedBackboneCandidates(+ selected,+ selectedEdgeIds,+ nodeUseCounts,+ pairUseCounts,+ structuralCandidates.values(),+ MAX_BACKBONE_TOTAL_EDGES - selected.length,+ );- const edgeIds = [...selectedEdgeIds]- .filter((edgeId) => graphRef.hasEdge(edgeId))- .sort((left, right) => left.localeCompare(right));+ const edgeIds = selected+ .map((entry) => entry.edgeId)+ .filter((edgeId) => graphRef.hasEdge(edgeId));return {ready: edgeIds.length > 0,diff --git a/explorer/src/workspaces/GraphWorkspace/graphSceneLayers.ts b/explorer/src/workspaces/GraphWorkspace/graphSceneLayers.tsindex 91a8b257..e7dae918 100644--- a/explorer/src/workspaces/GraphWorkspace/graphSceneLayers.ts+++ b/explorer/src/workspaces/GraphWorkspace/graphSceneLayers.ts@@ -266,8 +266,8 @@ function renderDensityField((GRAPH_THEME.effects.semanticRegions.splatRadius + sample.size * 0.9) * scale,);const gradient = context.createRadialGradient(x, y, 0, x, y, radius);- gradient.addColorStop(0, "rgba(255,255,255,0.22)");- gradient.addColorStop(0.58, "rgba(255,255,255,0.08)");+ gradient.addColorStop(0, "rgba(255,255,255,0.05)");+ gradient.addColorStop(0.58, "rgba(255,255,255,0.02)");gradient.addColorStop(1, "rgba(255,255,255,0)");context.fillStyle = gradient;context.beginPath();diff --git a/explorer/src/workspaces/GraphWorkspace/graphSceneState.ts b/explorer/src/workspaces/GraphWorkspace/graphSceneState.tsindex 401331ba..d2ef696f 100644--- a/explorer/src/workspaces/GraphWorkspace/graphSceneState.ts+++ b/explorer/src/workspaces/GraphWorkspace/graphSceneState.ts@@ -9,6 +9,7 @@ import {type GraphBadgeKind,type GraphEdgeVariant,type GraphEdgeVisualState,+ type GraphEntityShapeVariant,type GraphLabelVisibilityPolicy,type GraphNodeShapeVariant,type GraphNodeVisualState,@@ -22,6 +23,7 @@ import { computeGraphAnalyticsBase } from "./graphAnalytics";import type {GraphDisplayMeta,GraphDisplayStateSnapshot,+ GraphFullEdgeClass,GraphInteractionState,GraphSelectedNodeKind,GraphViewMode,@@ -84,6 +86,9 @@ export type ResolvedNodeStyle = {borderColor: string;borderSize: number;nodeVariant: GraphNodeShapeVariant;+ entityShape: GraphEntityShapeVariant;+ entityShapeKind: number;+ entityAspectRatio: number;badgeKind?: GraphBadgeKind;badgeCount?: number;showBadge: boolean;@@ -597,6 +602,7 @@ function resolveNodeColor() {const semanticColor = String(attrs.baseColor || fallbackColor || theme.palette.semantic[0]);const isCommunityGroup = Boolean(attrs.isCommunityGroup);+ const entityShapeConfig = theme.nodes.entityShapes[resolveEntityShape(attrs)];const overviewTint = state === "neighbor"? theme.palette.overview.nodeTintMix + 0.09: theme.palette.overview.nodeTintMix;@@ -628,10 +634,10 @@ function resolveNodeColor();return withAlpha(boostedCore,- isCommunityGroup ? Math.min(overviewAlpha, theme.grouped.style.fillAlpha) : overviewAlpha,+ isCommunityGroup ? Math.min(overviewAlpha, theme.grouped.style.fillAlpha) : Math.min(overviewAlpha, entityShapeConfig.fillAlpha),);}- return isCommunityGroup ? withAlpha(semanticColor, theme.grouped.style.fillAlpha) : semanticColor;+ return withAlpha(semanticColor, isCommunityGroup ? theme.grouped.style.fillAlpha : entityShapeConfig.fillAlpha);}}@@ -645,39 +651,36 @@ function resolveNodeShellColor() {const semanticColor = String(attrs.baseColor || fallbackColor || theme.palette.semantic[0]);const isCommunityGroup = Boolean(attrs.isCommunityGroup);+ const entityShapeConfig = theme.nodes.entityShapes[resolveEntityShape(attrs)];const presenceBoost = getOverviewPresenceBoost(cameraRatio);- const overviewShell = blendHex(- theme.palette.overview.nodeBase,- semanticColor,- (state === "neighbor" ? 0.02 : 0.012) + presenceBoost * 0.024,- );+ const overviewGlyph = blendHex(semanticColor, theme.ui.text.strong, 0.34 + presenceBoost * 0.12);if (zoomTier !== "overview") {return withAlpha(- blendHex(theme.palette.overview.nodeBase, semanticColor, 0.26),- isCommunityGroup ? theme.grouped.style.shellAlpha : 0.95,+ blendHex(semanticColor, theme.ui.text.strong, state === "default" ? 0.26 : 0.42),+ isCommunityGroup ? theme.grouped.style.shellAlpha : Math.min(0.72, entityShapeConfig.shellAlpha + 0.12),);}if (state === "selected") {- return withAlpha(blendHex(theme.palette.overview.nodeBase, theme.palette.accent.selected, 0.05), 0.98);+ return withAlpha(blendHex(theme.palette.accent.selected, theme.ui.text.strong, 0.24), 0.92);}if (state === "hovered") {- return withAlpha(blendHex(theme.palette.overview.nodeBase, theme.palette.accent.hovered, 0.06), 0.98);+ return withAlpha(blendHex(theme.palette.accent.hovered, theme.ui.text.strong, 0.22), 0.9);}if (state === "path") {- return withAlpha(blendHex(theme.palette.overview.nodeBase, theme.palette.accent.path, 0.06), 0.97);+ return withAlpha(blendHex(theme.palette.accent.path, theme.ui.text.strong, 0.22), 0.9);}if (state === "muted" || state === "inactive") {- return withAlpha(theme.palette.overview.nodeMuted, 0.22);+ return withAlpha(theme.palette.overview.nodeBorder, 0.16);}return withAlpha(- overviewShell,- isCommunityGroup ? theme.grouped.style.shellAlpha : theme.palette.overview.nodeShellAlpha,+ overviewGlyph,+ isCommunityGroup ? theme.grouped.style.shellAlpha : Math.min(0.58, entityShapeConfig.shellAlpha + 0.08),);}@@ -730,12 +733,17 @@ function resolveEdgeColor(state: GraphEdgeVisualState,attrs: EdgeAttributes,fallbackColor?: string,+ fullEdgeClass?: GraphFullEdgeClass,) {const defaultInspectionColor = zoomTier === "overview"? theme.palette.overview.edgeInspection: theme.palette.muted.edgeInspection;const baseColor = String(attrs.baseColor || fallbackColor || defaultInspectionColor);+ if (fullEdgeClass === "bridge") {+ return theme.palette.muted.edgeFocus;+ }+switch (theme.edges.states[state].color) {case "hover":return theme.palette.accent.hovered;@@ -760,12 +768,117 @@ function resolveEdgeColor(case "muted":return zoomTier === "overview"? theme.palette.overview.edgeStructure- : String(attrs.mutedColor || theme.palette.muted.edgeOverview);+ : theme.palette.muted.edgeOverview;default:return baseColor;}}+function resolveEdgeVisibilityPolicy(+ theme: GraphTheme,+ viewMode: GraphViewMode,+ zoomTier: GraphZoomTier,+ isCommunityBundle: boolean,+) {+ const policyMode = isCommunityBundle ? "grouped" : viewMode;+ return theme.edges.visibility[policyMode][zoomTier];+}++function isContextEdgeState(state: GraphEdgeVisualState): boolean {+ return state === "path"+ || state === "selected"+ || state === "hovered"+ || state === "neighbor"+ || state === "backbone";+}++function isNonCriticalEdgeVariant(variant: GraphEdgeVariant): boolean {+ return variant === "line"+ || variant === "directional"+ || variant === "parallelCurve"+ || variant === "bidirectionalCurve";+}++function shouldSampleOutBackgroundEdge(+ sampleRate: number,+ visualPriority: number,+ edgeId?: string,+ sourceId?: string,+ targetId?: string,+): boolean {+ if (sampleRate >= 1) {+ return false;+ }++ const sampleKey = edgeId || `${sourceId ?? "?"}->${targetId ?? "?"}`;+ const bucket = (hashString(sampleKey) % 10000) / 10000;+ const priorityAdjustedSampleRate = Math.min(1, sampleRate + visualPriority * 0.08);+ return bucket > priorityAdjustedSampleRate;+}++function resolveEdgeLodAlpha(+ theme: GraphTheme,+ viewMode: GraphViewMode,+ zoomTier: GraphZoomTier,+ state: GraphEdgeVisualState,+ attrs: EdgeAttributes,+ isCommunityBundle: boolean,+ fullEdgeClass?: GraphFullEdgeClass,+): number | null {+ const policy = resolveEdgeVisibilityPolicy(theme, viewMode, zoomTier, isCommunityBundle);+ if (viewMode === "full") {+ if (fullEdgeClass === "path" || state === "path") {+ return theme.interaction.pathEdgeAlpha;+ }+ if (fullEdgeClass === "selected" || state === "selected") {+ return theme.interaction.selectedEdgeAlpha;+ }+ if (fullEdgeClass === "local-context" || state === "hovered") {+ return theme.interaction.localContextAlpha;+ }+ if (fullEdgeClass === "bridge") {+ return theme.edges.fullGraphStructure.bridgeAlpha;+ }+ if (fullEdgeClass === "backbone") {+ return theme.edges.fullGraphStructure.backboneAlpha;+ }+ if (state === "backbone") {+ return theme.edges.fullGraphStructure.ambientBackboneAlpha;+ }+ if (state === "default" && zoomTier === "structure") {+ return theme.edges.fullGraphStructure.structureEdgeAlpha;+ }+ if (state === "default" && zoomTier === "inspection") {+ return theme.edges.fullGraphStructure.inspectionEdgeAlpha;+ }+ }+ if (state === "path") {+ return theme.interaction.pathEdgeAlpha;+ }+ if (state === "selected" || state === "hovered") {+ return state === "selected" ? theme.interaction.selectedEdgeAlpha : theme.interaction.hoverContextAlpha;+ }+ if (state === "default") {+ return policy.defaultAlpha;+ }+ if (state === "muted") {+ return policy.mutedAlpha;+ }+ if (state === "inactive") {+ return policy.inactiveAlpha;+ }+ if (state === "neighbor") {+ if (attrs.bundleKind === "community") {+ return Math.max(policy.neighborAlpha, theme.grouped.style.edgeAlpha);+ }+ return policy.neighborAlpha;+ }+ if (isCommunityBundle && !isContextEdgeState(state)) {+ return theme.grouped.style.edgeAlpha;+ }+ return null;+}+function resolveNodeRingColor(theme: GraphTheme,state: GraphNodeVisualState,@@ -846,7 +959,7 @@ export function resolveEdgeVisualState(selectedEdgeId: string,focusIds: Set<string>,pathEdgeIds: Set<string>,- overviewBackboneEdgeIds: Set<string>,+ highlightedIncidentEdgeIds: Set<string> = new Set(),): GraphEdgeVisualState {const primaryNodeId = hoveredNodeId || selectedNodeId;@@ -859,17 +972,16 @@ export function resolveEdgeVisualState(}if (primaryNodeId && (source === primaryNodeId || target === primaryNodeId)) {- return hoveredNodeId ? "hovered" : "selected";+ if (highlightedIncidentEdgeIds.has(edgeId)) {+ return hoveredNodeId ? "hovered" : "selected";+ }+ return "muted";}if (zoomTier !== "overview" && focusIds.has(source) && focusIds.has(target)) {return "neighbor";}- if (zoomTier === "overview" && overviewBackboneEdgeIds.has(edgeId)) {- return "backbone";- }-if (hoveredNodeId || selectedNodeId || selectedEdgeId || pathEdgeIds.size > 0) {return "muted";}@@ -881,6 +993,90 @@ export function resolveEdgeVisualState(return "default";}+function getNodeBridgeGroup(attrs?: NodeAttributes): string {+ if (!attrs) {+ return "";+ }+ return String(attrs.communityId || attrs.semanticGroup || attrs.nodeType || "");+}++function isCuratedBridgeEdge(sourceAttrs?: NodeAttributes, targetAttrs?: NodeAttributes): boolean {+ const sourceGroup = getNodeBridgeGroup(sourceAttrs);+ const targetGroup = getNodeBridgeGroup(targetAttrs);+ return Boolean(sourceGroup && targetGroup && sourceGroup !== targetGroup);+}++export function classifyFullGraphEdge(+ edgeId: string,+ source: string,+ target: string,+ zoomTier: GraphZoomTier,+ hoveredNodeId: string | null,+ selectedNodeId: string,+ selectedEdgeId: string,+ focusIds: Set<string>,+ pathEdgeIds: Set<string>,+ highlightedIncidentEdgeIds: Set<string> = new Set(),+ overviewBackboneEdgeIds: Set<string> = new Set(),+ sourceAttrs?: NodeAttributes,+ targetAttrs?: NodeAttributes,+): GraphFullEdgeClass {+ const primaryNodeId = hoveredNodeId || selectedNodeId;++ if (pathEdgeIds.has(edgeId)) {+ return "path";+ }++ if (selectedEdgeId && edgeId === selectedEdgeId) {+ return "selected";+ }++ if (highlightedIncidentEdgeIds.has(edgeId)) {+ return "local-context";+ }++ if (primaryNodeId && (source === primaryNodeId || target === primaryNodeId)) {+ return "muted";+ }++ if (overviewBackboneEdgeIds.has(edgeId)) {+ return isCuratedBridgeEdge(sourceAttrs, targetAttrs) ? "bridge" : "backbone";+ }++ if (zoomTier === "overview") {+ return "hidden";+ }++ if (focusIds.has(source) && focusIds.has(target)) {+ return "muted";+ }++ return "muted";+}++export function mapFullEdgeClassToVisualState(+ edgeClass: GraphFullEdgeClass,+ options: { hoveredNodeId: string | null; hasActiveInteraction: boolean },+): GraphEdgeVisualState {+ switch (edgeClass) {+ case "path":+ return "path";+ case "selected":+ return "selected";+ case "local-context":+ return options.hoveredNodeId ? "hovered" : "selected";+ case "backbone":+ return "backbone";+ case "bridge":+ return "backbone";+ case "hidden":+ return "inactive";+ case "muted":+ default:+ return options.hasActiveInteraction ? "muted" : "default";+ }+}+export function resolveNodeVariant(state: GraphNodeVisualState, attrs: NodeAttributes): GraphNodeShapeVariant {if (state === "selected") {return "selected";@@ -889,6 +1085,14 @@ export function resolveNodeVariant(state: GraphNodeVisualState, attrs: NodeAttrireturn attrs.nodeShapeVariant || attrs.nodeVariant || "default";}+export function resolveEntityShape(attrs: NodeAttributes): GraphEntityShapeVariant {+ if (attrs.isCommunityGroup) {+ return "community";+ }++ return attrs.entityShape || "entity";+}+export function resolveEdgeVariant(state: GraphEdgeVisualState, attrs: EdgeAttributes): GraphEdgeVariant {if (state === "path") {return "pathSignal";@@ -1001,6 +1205,8 @@ export function resolveNodeElementStyle(const stateConfig = theme.nodes.states[state];const nodeVariant = resolveNodeVariant(state, attrs);const variantConfig = theme.nodes.variants[nodeVariant];+ const entityShape = resolveEntityShape(attrs);+ const entityShapeConfig = theme.nodes.entityShapes[entityShape];const isCommunityGroup = Boolean(attrs.isCommunityGroup);const baseSize = Number(attrs.baseSize || attrs.size || 4);const labelPriority = Number(attrs.labelPriority ?? 0);@@ -1028,12 +1234,17 @@ export function resolveNodeElementStyle(: forceVisibleState? theme.nodes.strokeHierarchy[zoomTier].emphasis: theme.nodes.strokeHierarchy[zoomTier].base;+ const rawCoreScale = resolveNodeCoreScale(zoomTier, state, cameraRatio) * entityShapeConfig.coreScale;+ const shouldShowGlyphHint = zoomTier !== "overview"+ || state === "hovered"+ || state === "selected"+ || state === "path";return {color,shellColor,- coreScale: resolveNodeCoreScale(zoomTier, state, cameraRatio),- size: Math.max(baseSize * sizeMultiplier * overviewPresence, stateConfig.minSize),+ coreScale: shouldShowGlyphHint ? clamp(0.06, rawCoreScale, 0.5) : 0,+ size: Math.max(baseSize * sizeMultiplier * overviewPresence, stateConfig.minSize, entityShapeConfig.minSize),forceLabel,label: forceLabel ? label : "",zIndex: forceLabel && stateConfig.zIndex === 0 ? 1 : stateConfig.zIndex,@@ -1045,10 +1256,14 @@ export function resolveNodeElementStyle(+ strokeBase+ stateConfig.borderBoost+ variantConfig.borderBoost+ + entityShapeConfig.borderBoost+ (isCommunityGroup ? theme.grouped.style.nodeBorderBoost : 0)- 0.8,),nodeVariant,+ entityShape,+ entityShapeKind: entityShapeConfig.shapeKind,+ entityAspectRatio: entityShapeConfig.aspectRatio,badgeKind,badgeCount: attrs.badgeCount,showBadge,@@ -1069,6 +1284,7 @@ function resolveStraightEdgeType(state: GraphEdgeVisualState,variant: GraphEdgeVariant,attrs: EdgeAttributes,+ viewMode: GraphViewMode,): "line" | "arrow" {const variantConfig = theme.edges.variants[variant];@@ -1076,6 +1292,14 @@ function resolveStraightEdgeType(return "arrow";}+ if ((viewMode === "full" || viewMode === "grouped") && state === "default") {+ return "line";+ }++ if (viewMode === "full" && state === "backbone") {+ return "line";+ }+if (variantConfig.arrowPolicy === "contextual" && theme.zoomTiers[zoomTier].showContextualArrows) {return "arrow";}@@ -1125,6 +1349,9 @@ export function resolveEdgeElementStyle(attrs: EdgeAttributes,sourceId?: string,targetId?: string,+ viewMode: GraphViewMode = "full",+ edgeId?: string,+ fullEdgeClass?: GraphFullEdgeClass,): ResolvedEdgeStyle {const tierConfig = theme.zoomTiers[zoomTier];const stateConfig = theme.edges.states[state];@@ -1133,11 +1360,29 @@ export function resolveEdgeElementStyle(const isCommunityBundle = attrs.bundleKind === "community";const baseSize = Number(attrs.baseSize || attrs.size || 0.9);const visualPriority = Number(attrs.visualPriority ?? 0);+ const isFullBridgeEdge = viewMode === "full" && fullEdgeClass === "bridge";+ const isFullBackboneEdge = viewMode === "full" && fullEdgeClass === "backbone";+ const shouldCurveBridge = isFullBridgeEdge+ && visualPriority >= theme.edges.fullGraphStructure.bridgeCurvePriorityThreshold;+ const visibilityPolicy = resolveEdgeVisibilityPolicy(theme, viewMode, zoomTier, isCommunityBundle);+ const isContextEdge = isContextEdgeState(state);+ const isNonCriticalEdge = isNonCriticalEdgeVariant(edgeVariant);const belowPriorityThreshold = state === "default"- && visualPriority < tierConfig.edgePriorityThreshold- && edgeVariant === "line";+ && visualPriority < Math.max(tierConfig.edgePriorityThreshold, visibilityPolicy.defaultPriorityThreshold)+ && isNonCriticalEdge;+ const hiddenByMutedState = (state === "muted" || state === "inactive") && visibilityPolicy.hideMuted;+ const sampledOut = isNonCriticalEdge+ && (+ (state === "default" && !isContextEdge && shouldSampleOutBackgroundEdge(visibilityPolicy.backgroundSampleRate, visualPriority, edgeId, sourceId, targetId))+ || (+ state === "backbone"+ && zoomTier === "overview"+ && viewMode !== "full"+ && shouldSampleOutBackgroundEdge(0.15, visualPriority, edgeId, sourceId, targetId)+ )+ );- if (stateConfig.hide || belowPriorityThreshold) {+ if (stateConfig.hide || belowPriorityThreshold || hiddenByMutedState || sampledOut) {return {hidden: true,zIndex: 0,@@ -1148,31 +1393,55 @@ export function resolveEdgeElementStyle(};}- const sizeMultiplier = (state === "default" ? tierConfig.edgeSizeScale : stateConfig.sizeMultiplier) * variantConfig.sizeMultiplier;- const straightType = resolveStraightEdgeType(theme, zoomTier, state, edgeVariant, attrs);+ const lodSizeMultiplier = isContextEdge ? 1 : visibilityPolicy.sizeMultiplier;+ const sizeMultiplier = (state === "default" ? tierConfig.edgeSizeScale : stateConfig.sizeMultiplier)+ * variantConfig.sizeMultiplier+ * lodSizeMultiplier;+ const straightType = resolveStraightEdgeType(theme, zoomTier, state, edgeVariant, attrs, viewMode);const useCurvedRenderer = tierConfig.showCurves- && zoomTier !== "overview"&& (edgeVariant === "pathSignal"|| state === "selected"- || ((state === "neighbor" || state === "hovered") && (edgeVariant === "bidirectionalCurve" || edgeVariant === "parallelCurve"))+ || shouldCurveBridge+ || edgeVariant === "bidirectionalCurve"+ || edgeVariant === "parallelCurve");- const curvature = useCurvedRenderer- ? resolveEdgeCurvature(theme, state, edgeVariant, attrs, sourceId, targetId)- : 0;+ const curvature = shouldCurveBridge+ ? (sourceId && targetId && sourceId.localeCompare(targetId) > 0+ ? -theme.edges.fullGraphStructure.bridgeCurveStrength+ : theme.edges.fullGraphStructure.bridgeCurveStrength)+ : useCurvedRenderer+ ? resolveEdgeCurvature(theme, state, edgeVariant, attrs, sourceId, targetId)+ : 0;+ const baseColor = resolveEdgeColor(theme, zoomTier, state, attrs, attrs.color, fullEdgeClass);+ const lodAlpha = resolveEdgeLodAlpha(theme, viewMode, zoomTier, state, attrs, isCommunityBundle, fullEdgeClass);+ const color = lodAlpha === null ? baseColor : withAlpha(baseColor, lodAlpha);+ const rawSize = Math.max(+ baseSize * sizeMultiplier * (isCommunityBundle ? theme.grouped.style.edgeSizeScale : 1),+ stateConfig.minSize,+ );++ const interactionMaxSize = (fullEdgeClass === "path" || state === "path")+ ? theme.interaction.pathEdgeMaxSize+ : (fullEdgeClass === "selected" || state === "selected")+ ? theme.interaction.selectedEdgeMaxSize+ : (fullEdgeClass === "local-context" || state === "hovered" || state === "neighbor")+ ? theme.interaction.localContextMaxSize+ : Number.POSITIVE_INFINITY;++ const size = isFullBridgeEdge+ ? Math.min(rawSize, theme.edges.fullGraphStructure.bridgeMaxSize)+ : isFullBackboneEdge+ ? Math.min(rawSize, theme.edges.fullGraphStructure.backboneMaxSize)+ : Math.min(rawSize, interactionMaxSize);return {hidden: false,type: useCurvedRenderer? (straightType === "arrow" ? "curvedArrow" : "curve"): straightType,- color: isCommunityBundle- ? withAlpha(resolveEdgeColor(theme, zoomTier, state, attrs, attrs.color), theme.grouped.style.edgeAlpha)- : resolveEdgeColor(theme, zoomTier, state, attrs, attrs.color),- size: Math.max(- baseSize * sizeMultiplier * (isCommunityBundle ? theme.grouped.style.edgeSizeScale : 1),- stateConfig.minSize,- ),+ color: color,+ size,zIndex: stateConfig.zIndex,edgeVariant,arrowVisibilityPolicy: variantConfig.arrowPolicy,@@ -1675,6 +1944,7 @@ function buildCommunityGroupedGraph(): GraphDisplayResult {mutedColor: withAlpha(summary.color, 0.22),glowColor: withAlpha(summary.color, GRAPH_THEME.grouped.style.glowAlpha),borderColor: withAlpha(summary.color, 0.74),+ entityShape: "community",nodeType: "community",semanticGroup: summary.dominantSemanticGroup,labelVisibilityPolicy: position.labelPriority > 0.9 ? "priority" : "none",@@ -1901,30 +2171,42 @@ export function createFocusedGraph(});});- for (const source of focusIds) {- for (const target of focusIds) {- if (source === target) {- continue;- }- forEachDirectedEdgeBetween(graph, source, target, (edgeId, attrs) => {- const state: GraphEdgeVisualState = pathEdgeIds.has(edgeId)- ? "path"- : source === nodeId || target === nodeId- ? "selected"- : "neighbor";- const style = resolveEdgeElementStyle(GRAPH_THEME, "inspection", state, attrs, source, target);- focused.mergeDirectedEdgeWithKey(edgeId, source, target, {- ...attrs,- type: style.type,- size: style.size,- color: style.color,- baseSize: style.size,- baseColor: style.color,- curvature: style.curvature,+ collectFocusEdgeIds(graph, focusIds).forEach((edgeId) => {+ if (!graph.hasEdge(edgeId)) {+ return;+ }++ const [source, target] = graph.extremities(edgeId);+ if (!focusIds.has(source) || !focusIds.has(target) || source === target) {+ if (DEBUG_GRAPH_SCENE_STATE) {+ console.debug("[graphSceneState]", "focused-edge-skipped-invalid-endpoints", {+ edgeId,+ source,+ target,+ selectedNodeId: nodeId,});- });+ }+ return;}- }++ const attrs = graph.getEdgeAttributes(edgeId) as EdgeAttributes;+ const state: GraphEdgeVisualState = pathEdgeIds.has(edgeId)+ ? "path"+ : source === nodeId || target === nodeId+ ? "selected"+ : "neighbor";+ const style = resolveEdgeElementStyle(GRAPH_THEME, "inspection", state, attrs, source, target, "focused", edgeId);++ focused.mergeDirectedEdgeWithKey(edgeId, source, target, {+ ...attrs,+ type: style.type,+ size: style.size,+ color: style.color,+ baseSize: style.size,+ baseColor: style.color,+ curvature: style.curvature,+ });+ });return aggregateDisplayGraph(focused);}diff --git a/explorer/src/workspaces/GraphWorkspace/graphStructureLayer.ts b/explorer/src/workspaces/GraphWorkspace/graphStructureLayer.tsnew file mode 100644index 00000000..0a6d257f--- /dev/null+++ b/explorer/src/workspaces/GraphWorkspace/graphStructureLayer.ts@@ -0,0 +1,335 @@+import type Graph from "graphology";+import type Sigma from "sigma";++import type { EdgeAttributes, NodeAttributes } from "../../store/graphStore";+import { GRAPH_THEME, withAlpha } from "./graphTheme";+import type {+ GraphFullEdgeClass,+ GraphFullEdgeClassDiagnostics,+ GraphInteractionState,+ GraphStructureLayerDiagnostics,+ GraphStructureLayerDisabledReason,+ GraphViewMode,+} from "./types";++type GraphRef = Graph;++type StructureLayerMode = typeof GRAPH_THEME.edges.fullGraphStructureLayer.mode;++export type GraphStructureCurve = {+ edgeId: string;+ sourceId: string;+ targetId: string;+ source: { x: number; y: number };+ target: { x: number; y: number };+ edgeClass: Extract<GraphFullEdgeClass, "backbone" | "bridge">;+ priority: number;+ curvature: number;+};++export type GraphStructureCurveCache = {+ cacheKey: string;+ curves: GraphStructureCurve[];+ bridgeCurveCount: number;+ backboneCurveCount: number;+};++export type GraphStructureLayerGateInput = {+ mode: StructureLayerMode;+ viewMode: GraphViewMode;+ isLayoutRunning: boolean;+ edgeDiagnostics?: GraphFullEdgeClassDiagnostics;+ minimumLiteralEdges: number;+};++export type GraphStructureLayerGate = {+ enabled: boolean;+ disabledReason: GraphStructureLayerDisabledReason | null;+};++export function evaluateGraphStructureLayerGate({+ mode,+ viewMode,+ isLayoutRunning,+ edgeDiagnostics,+ minimumLiteralEdges,+}: GraphStructureLayerGateInput): GraphStructureLayerGate {+ if (mode === "off") {+ return { enabled: false, disabledReason: "disabled" };+ }++ if (viewMode !== "full") {+ return { enabled: false, disabledReason: "non-full-mode" };+ }++ if (isLayoutRunning) {+ return { enabled: false, disabledReason: "layout-running" };+ }++ if (mode === "auto") {+ const literalEdges = (edgeDiagnostics?.counts.backbone ?? 0) + (edgeDiagnostics?.counts.bridge ?? 0);+ if (literalEdges >= minimumLiteralEdges) {+ return { enabled: false, disabledReason: "enough-literal-edges" };+ }+ }++ return { enabled: true, disabledReason: null };+}++function isFinitePoint(attrs: NodeAttributes) {+ return Number.isFinite(Number(attrs.x)) && Number.isFinite(Number(attrs.y));+}++function getEdgePriority(attrs: EdgeAttributes) {+ return Math.max(0, Math.min(1, Number(attrs.visualPriority ?? attrs.weight ?? 0)));+}++function getCurveSortRank(edgeClass: GraphFullEdgeClass, priority: number) {+ return (edgeClass === "bridge" ? 2 : 1) + priority;+}++function getDeterministicCurveSign(sourceId: string, targetId: string, edgeId: string) {+ const seed = `${sourceId}|${targetId}|${edgeId}`;+ let hash = 0;+ for (let index = 0; index < seed.length; index += 1) {+ hash = (hash * 31 + seed.charCodeAt(index)) | 0;+ }+ return hash % 2 === 0 ? 1 : -1;+}++export function createGraphStructureCacheKey({+ graphVersion,+ zoomTier,+ layoutSettledEpoch,+ overviewBackboneEdgeIds,+}: {+ graphVersion: number;+ zoomTier: GraphInteractionState["zoomTier"];+ layoutSettledEpoch: number;+ overviewBackboneEdgeIds: Set<string>;+}) {+ return [+ graphVersion,+ zoomTier,+ layoutSettledEpoch,+ Array.from(overviewBackboneEdgeIds).sort().join(","),+ ].join("|");+}++export function buildGraphStructureCurveCache({+ graphRef,+ cacheKey,+ classifyEdge,+ maxCurves,+ curveStrength,+}: {+ graphRef: GraphRef;+ cacheKey: string;+ classifyEdge: (edgeId: string) => GraphFullEdgeClass;+ maxCurves: number;+ curveStrength: number;+}): GraphStructureCurveCache {+ const candidates: Array<GraphStructureCurve & { rank: number }> = [];++ graphRef.forEachEdge((edgeId, attrs, source, target) => {+ const stableEdgeId = String(edgeId);+ const edgeClass = classifyEdge(stableEdgeId);+ if (edgeClass !== "bridge" && edgeClass !== "backbone") {+ return;+ }++ const sourceId = String(source);+ const targetId = String(target);+ if (!graphRef.hasNode(sourceId) || !graphRef.hasNode(targetId)) {+ return;+ }++ const sourceAttrs = graphRef.getNodeAttributes(sourceId) as NodeAttributes;+ const targetAttrs = graphRef.getNodeAttributes(targetId) as NodeAttributes;+ if (!isFinitePoint(sourceAttrs) || !isFinitePoint(targetAttrs)) {+ return;+ }++ const priority = getEdgePriority(attrs as EdgeAttributes);+ candidates.push({+ edgeId: stableEdgeId,+ sourceId,+ targetId,+ source: { x: Number(sourceAttrs.x), y: Number(sourceAttrs.y) },+ target: { x: Number(targetAttrs.x), y: Number(targetAttrs.y) },+ edgeClass,+ priority,+ curvature: getDeterministicCurveSign(sourceId, targetId, stableEdgeId) * curveStrength,+ rank: getCurveSortRank(edgeClass, priority),+ });+ });++ candidates.sort((left, right) => {+ if (right.rank !== left.rank) {+ return right.rank - left.rank;+ }+ return left.edgeId.localeCompare(right.edgeId);+ });++ const curves = candidates.slice(0, maxCurves).map(({ rank: _rank, ...curve }) => curve);+ return {+ cacheKey,+ curves,+ bridgeCurveCount: curves.filter((curve) => curve.edgeClass === "bridge").length,+ backboneCurveCount: curves.filter((curve) => curve.edgeClass === "backbone").length,+ };+}++export function getGraphStructureLayerDiagnostics({+ gate,+ cache,+ minimumCurves,+ canvasAvailable,+ lastDrawAt,+}: {+ gate: GraphStructureLayerGate;+ cache: GraphStructureCurveCache | null;+ minimumCurves: number;+ canvasAvailable: boolean;+ lastDrawAt: number | null;+}): GraphStructureLayerDiagnostics {+ if (!gate.enabled) {+ return {+ enabled: false,+ disabledReason: gate.disabledReason,+ curveCount: 0,+ bridgeCurveCount: 0,+ backboneCurveCount: 0,+ cacheKey: cache?.cacheKey ?? "",+ lastDrawAt,+ };+ }++ if (!canvasAvailable) {+ return {+ enabled: false,+ disabledReason: "invalid-layer",+ curveCount: 0,+ bridgeCurveCount: 0,+ backboneCurveCount: 0,+ cacheKey: cache?.cacheKey ?? "",+ lastDrawAt,+ };+ }++ if (!cache || cache.curves.length === 0) {+ return {+ enabled: false,+ disabledReason: "no-eligible-edges",+ curveCount: 0,+ bridgeCurveCount: 0,+ backboneCurveCount: 0,+ cacheKey: cache?.cacheKey ?? "",+ lastDrawAt,+ };+ }++ if (cache.curves.length < minimumCurves) {+ return {+ enabled: false,+ disabledReason: "cache-empty",+ curveCount: cache.curves.length,+ bridgeCurveCount: cache.bridgeCurveCount,+ backboneCurveCount: cache.backboneCurveCount,+ cacheKey: cache.cacheKey,+ lastDrawAt,+ };+ }++ return {+ enabled: true,+ disabledReason: null,+ curveCount: cache.curves.length,+ bridgeCurveCount: cache.bridgeCurveCount,+ backboneCurveCount: cache.backboneCurveCount,+ cacheKey: cache.cacheKey,+ lastDrawAt,+ };+}++export function clearGraphStructureLayer(canvas: HTMLCanvasElement | null) {+ if (!canvas) {+ return;+ }+ const context = canvas.getContext("2d");+ if (!context) {+ return;+ }+ context.setTransform(1, 0, 0, 1, 0, 0);+ context.clearRect(0, 0, canvas.width, canvas.height);+}++export function drawGraphStructureLayer({+ sigma,+ canvas,+ cache,+}: {+ sigma: Sigma;+ canvas: HTMLCanvasElement;+ cache: GraphStructureCurveCache;+}) {+ const context = canvas.getContext("2d");+ if (!context) {+ return false;+ }++ const { width, height } = sigma.getDimensions();+ const pixelRatio = window.devicePixelRatio || 1;+ context.setTransform(pixelRatio, 0, 0, pixelRatio, 0, 0);+ context.clearRect(0, 0, width, height);+ context.lineCap = "round";+ context.lineJoin = "round";++ let drawn = 0;+ for (const curve of cache.curves) {+ const sourceData = sigma.getNodeDisplayData(curve.sourceId);+ const targetData = sigma.getNodeDisplayData(curve.targetId);+ if (!sourceData || !targetData || sourceData.hidden || targetData.hidden) {+ continue;+ }++ const sourcePoint = sigma.graphToViewport(curve.source);+ const targetPoint = sigma.graphToViewport(curve.target);+ if (+ !Number.isFinite(sourcePoint.x)+ || !Number.isFinite(sourcePoint.y)+ || !Number.isFinite(targetPoint.x)+ || !Number.isFinite(targetPoint.y)+ ) {+ continue;+ }++ const dx = targetPoint.x - sourcePoint.x;+ const dy = targetPoint.y - sourcePoint.y;+ const distance = Math.hypot(dx, dy);+ if (distance <= 0) {+ continue;+ }++ const nx = -dy / distance;+ const ny = dx / distance;+ const offset = distance * curve.curvature;+ const controlX = (sourcePoint.x + targetPoint.x) / 2 + nx * offset;+ const controlY = (sourcePoint.y + targetPoint.y) / 2 + ny * offset;+ const layerTheme = GRAPH_THEME.edges.fullGraphStructureLayer;++ context.beginPath();+ context.strokeStyle = curve.edgeClass === "bridge"+ ? withAlpha(GRAPH_THEME.palette.muted.edgeFocus, layerTheme.bridgeAlpha)+ : withAlpha(GRAPH_THEME.palette.muted.edgeStructure, layerTheme.backboneAlpha);+ context.lineWidth = curve.edgeClass === "bridge"+ ? layerTheme.bridgeLineWidth+ : layerTheme.backboneLineWidth;+ context.moveTo(sourcePoint.x, sourcePoint.y);+ context.quadraticCurveTo(controlX, controlY, targetPoint.x, targetPoint.y);+ context.stroke();+ drawn += 1;+ }++ return drawn > 0;+}diff --git a/explorer/src/workspaces/GraphWorkspace/graphTheme.ts b/explorer/src/workspaces/GraphWorkspace/graphTheme.tsindex a96429a0..dfa0ebb8 100644--- a/explorer/src/workspaces/GraphWorkspace/graphTheme.ts+++ b/explorer/src/workspaces/GraphWorkspace/graphTheme.ts@@ -2,6 +2,7 @@ export type GraphZoomTier = "overview" | "structure" | "inspection";export type GraphNodeVisualState = "default" | "hovered" | "selected" | "neighbor" | "path" | "inactive" | "muted";export type GraphEdgeVisualState = "default" | "backbone" | "hovered" | "selected" | "neighbor" | "path" | "inactive" | "muted";export type GraphNodeShapeVariant = "default" | "temporal" | "inferred" | "provenance" | "selected";+export type GraphEntityShapeVariant = "entity" | "biomolecule" | "condition" | "compound" | "process" | "community";export type GraphEdgeVariant = "line" | "directional" | "bidirectionalCurve" | "parallelCurve" | "pathSignal";export type GraphArrowVisibilityPolicy = "hidden" | "contextual" | "always";export type GraphLabelVisibilityPolicy = "none" | "priority" | "local" | "always";@@ -53,6 +54,60 @@ export interface GraphTheme {nodeBorder: string;};};+ ui: {+ text: {+ strong: string;+ body: string;+ muted: string;+ subtle: string;+ inverse: string;+ };+ surface: {+ app: string;+ stage: string;+ card: string;+ cardSubtle: string;+ cardStrong: string;+ panel: string;+ panelBorder: string;+ divider: string;+ shadow: string;+ };+ scene: {+ background: string;+ radialGlow: string;+ grid: string;+ gridStrong: string;+ vignette: string;+ };+ control: {+ defaultBg: string;+ defaultBorder: string;+ defaultText: string;+ hoverBg: string;+ activeBg: string;+ activeBorder: string;+ activeText: string;+ primaryBg: string;+ primaryBorder: string;+ primaryText: string;+ disabledText: string;+ inputBg: string;+ inputBorder: string;+ focusRing: string;+ dangerText: string;+ };+ timeline: {+ background: string;+ border: string;+ gridMinor: string;+ gridMajor: string;+ text: string;+ textStrong: string;+ playhead: string;+ playheadSoft: string;+ };+ };zoomTiers: Record<GraphZoomTier, {maxRatio: number;nodeScale: number;@@ -134,6 +189,16 @@ export interface GraphTheme {badgeKind?: GraphBadgeKind;badgeVisibleFrom: GraphZoomTier;}>;+ entityShapes: Record<GraphEntityShapeVariant, {+ label: string;+ shapeKind: number;+ aspectRatio: number;+ fillAlpha: number;+ shellAlpha: number;+ coreScale: number;+ borderBoost: number;+ minSize: number;+ }>;selectedRing: {color: string;width: number;@@ -171,6 +236,49 @@ export interface GraphTheme {sizeMultiplier: number;glowAlpha: number;}>;+ visibility: Record<"full" | "grouped" | "focused", Record<GraphZoomTier, {+ defaultPriorityThreshold: number;+ backgroundSampleRate: number;+ defaultAlpha: number;+ mutedAlpha: number;+ inactiveAlpha: number;+ neighborAlpha: number;+ sizeMultiplier: number;+ hideMuted: boolean;+ }>>;+ contextCaps: Record<"full" | "grouped" | "focused", Record<GraphZoomTier, number>>;+ fullGraphStructure: {+ ambientBackboneAlpha: number;+ backboneAlpha: number;+ bridgeAlpha: number;+ bridgeCurvePriorityThreshold: number;+ bridgeCurveStrength: number;+ backboneMaxSize: number;+ bridgeMaxSize: number;+ structureEdgeAlpha: number;+ inspectionEdgeAlpha: number;+ };+ fullGraphStructureLayer: {+ mode: "off" | "auto" | "always";+ minimumLiteralEdges: number;+ minimumCurves: number;+ maxCurves: number;+ bridgeAlpha: number;+ backboneAlpha: number;+ bridgeLineWidth: number;+ backboneLineWidth: number;+ curveStrength: number;+ };+ };+ interaction: {+ localContextAlpha: number;+ hoverContextAlpha: number;+ selectedEdgeAlpha: number;+ pathEdgeAlpha: number;+ localContextMaxSize: number;+ selectedEdgeMaxSize: number;+ pathEdgeMaxSize: number;+ pathOverlayAlpha: number;};overlays: {hoverGlowAlpha: number;@@ -302,9 +410,9 @@ export const GRAPH_THEME: GraphTheme = {nodeCoreMix: 0.72,nodeShellAlpha: 0.97,nodeCoreAlpha: 1,- edgeBackbone: "rgba(100, 148, 210, 0.38)",- edgeStructure: "rgba(88, 140, 200, 0.28)",- edgeInspection: "rgba(110, 165, 230, 0.48)",+ edgeBackbone: "rgba(84, 123, 145, 0.24)",+ edgeStructure: "rgba(49, 63, 78, 0.08)",+ edgeInspection: "rgba(76, 102, 128, 0.12)",},accent: {selected: "#F2D288",@@ -317,44 +425,98 @@ export const GRAPH_THEME: GraphTheme = {muted: {fallback: "rgba(96, 112, 136, 0.18)",nodeAlpha: 0.12,- edgeOverview: "rgba(82, 100, 124, 0.12)",- edgeStructure: "rgba(92, 112, 138, 0.18)",- edgeInspection: "rgba(124, 148, 176, 0.26)",- edgeFocus: "rgba(160, 186, 218, 0.42)",+ edgeOverview: "rgba(32, 45, 55, 0.035)",+ edgeStructure: "rgba(42, 58, 72, 0.055)",+ edgeInspection: "rgba(62, 84, 104, 0.075)",+ edgeFocus: "rgba(132, 178, 202, 0.26)",},background: {- canvas: "#07101A",- shell: "rgba(8, 15, 26, 0.8)",- shellBorder: "rgba(118, 162, 207, 0.14)",- shellGlow: "rgba(48, 88, 140, 0.14)",- grid: "rgba(92, 126, 170, 0.034)",- vignette: "rgba(2, 5, 11, 0.84)",- nodeBorder: "#0C1522",+ canvas: "#0A0D11",+ shell: "rgba(17, 21, 27, 0.82)",+ shellBorder: "rgba(170, 184, 205, 0.14)",+ shellGlow: "rgba(0, 0, 0, 0.28)",+ grid: "rgba(170, 184, 205, 0.026)",+ vignette: "rgba(3, 4, 7, 0.76)",+ nodeBorder: "#0B0F15",+ },+ },+ ui: {+ text: {+ strong: "#F3F0E8",+ body: "#D5D9DD",+ muted: "#9AA3AE",+ subtle: "#6F7A86",+ inverse: "#0B0D10",+ },+ surface: {+ app: "#08090B",+ stage: "#0B0E12",+ card: "linear-gradient(180deg, rgba(28, 31, 36, 0.88), rgba(16, 18, 23, 0.78))",+ cardSubtle: "linear-gradient(180deg, rgba(23, 26, 31, 0.72), rgba(13, 15, 19, 0.64))",+ cardStrong: "linear-gradient(180deg, rgba(34, 37, 43, 0.94), rgba(18, 21, 26, 0.9))",+ panel: "linear-gradient(180deg, rgba(21, 24, 30, 0.92), rgba(12, 14, 18, 0.9))",+ panelBorder: "rgba(211, 205, 190, 0.13)",+ divider: "rgba(211, 205, 190, 0.1)",+ shadow: "0 22px 60px rgba(0, 0, 0, 0.34), inset 0 1px 0 rgba(255, 255, 255, 0.045)",+ },+ scene: {+ background: "linear-gradient(180deg, #0B0E12 0%, #07080B 100%)",+ radialGlow: "radial-gradient(circle at 50% 18%, rgba(88, 224, 204, 0.07), transparent 30%), radial-gradient(circle at 78% 0%, rgba(217, 168, 92, 0.055), transparent 26%)",+ grid: "rgba(210, 206, 196, 0.024)",+ gridStrong: "rgba(210, 206, 196, 0.052)",+ vignette: "radial-gradient(ellipse at center, transparent 42%, rgba(2, 3, 5, 0.82) 100%)",+ },+ control: {+ defaultBg: "rgba(255, 255, 255, 0.035)",+ defaultBorder: "rgba(211, 205, 190, 0.11)",+ defaultText: "#D7D1C4",+ hoverBg: "rgba(255, 255, 255, 0.065)",+ activeBg: "linear-gradient(180deg, rgba(74, 181, 166, 0.24), rgba(38, 118, 116, 0.18))",+ activeBorder: "rgba(98, 226, 205, 0.42)",+ activeText: "#E8FFFA",+ primaryBg: "linear-gradient(180deg, rgba(55, 145, 132, 0.42), rgba(24, 86, 88, 0.28))",+ primaryBorder: "rgba(99, 228, 206, 0.34)",+ primaryText: "#F2FFFB",+ disabledText: "rgba(154, 163, 174, 0.42)",+ inputBg: "rgba(5, 7, 10, 0.52)",+ inputBorder: "rgba(211, 205, 190, 0.13)",+ focusRing: "rgba(98, 226, 205, 0.16)",+ dangerText: "#FF9A8D",+ },+ timeline: {+ background: "linear-gradient(180deg, rgba(14, 18, 24, 0.86), rgba(8, 11, 15, 0.92))",+ border: "rgba(170, 184, 205, 0.12)",+ gridMinor: "rgba(170, 184, 205, 0.04)",+ gridMajor: "rgba(170, 184, 205, 0.09)",+ text: "#7A92AE",+ textStrong: "#A5B7CD",+ playhead: "#8FE7FF",+ playheadSoft: "rgba(143, 231, 255, 0.12)",},},zoomTiers: {overview: {maxRatio: Number.POSITIVE_INFINITY,nodeScale: 0.72,- labelThreshold: 0.995,- labelBudget: 4,+ labelThreshold: 0.998,+ labelBudget: 2,edgePriorityThreshold: 0.72,arrowPriorityThreshold: Number.POSITIVE_INFINITY,edgeSizeScale: 0.62,showBadges: false,- showCurves: false,+ showCurves: true,showContextualArrows: false,},structure: {maxRatio: 1.2,nodeScale: 0.94,- labelThreshold: 0.93,- labelBudget: 18,+ labelThreshold: 0.95,+ labelBudget: 12,edgePriorityThreshold: 0.4,arrowPriorityThreshold: 0.75,edgeSizeScale: 0.92,showBadges: false,- showCurves: false,+ showCurves: true,showContextualArrows: false,},inspection: {@@ -428,11 +590,11 @@ export const GRAPH_THEME: GraphTheme = {inspection: { base: 1.2, emphasis: 1.7, muted: 0.6 },},states: {- default: { color: "base", sizeMultiplier: 0.72, minSize: 0.68, forceLabel: false, zIndex: 0, borderBoost: -0.42 },- hovered: { color: "hovered", sizeMultiplier: 1.1, minSize: 10.8, forceLabel: true, zIndex: 4, borderBoost: 0.18 },- selected: { color: "selected", sizeMultiplier: 1.02, minSize: 9.4, forceLabel: true, zIndex: 3, borderBoost: 0.18 },- neighbor: { color: "base", sizeMultiplier: 0.78, minSize: 4.2, forceLabel: false, zIndex: 2, borderBoost: -0.12 },- path: { color: "path", sizeMultiplier: 0.97, minSize: 5.8, forceLabel: true, zIndex: 2, borderBoost: 0.06 },+ default: { color: "base", sizeMultiplier: 0.7, minSize: 0.64, forceLabel: false, zIndex: 0, borderBoost: -0.46 },+ hovered: { color: "hovered", sizeMultiplier: 1.08, minSize: 10.4, forceLabel: true, zIndex: 4, borderBoost: 0.2 },+ selected: { color: "selected", sizeMultiplier: 1.02, minSize: 9.2, forceLabel: true, zIndex: 3, borderBoost: 0.22 },+ neighbor: { color: "base", sizeMultiplier: 0.76, minSize: 4, forceLabel: false, zIndex: 2, borderBoost: -0.08 },+ path: { color: "path", sizeMultiplier: 0.96, minSize: 5.6, forceLabel: true, zIndex: 2, borderBoost: 0.08 },inactive: { color: "muted", sizeMultiplier: 0.52, minSize: 0.58, forceLabel: false, zIndex: 0, borderBoost: -0.42 },muted: { color: "muted", sizeMultiplier: 0.52, minSize: 0.58, forceLabel: false, zIndex: 0, borderBoost: -0.42 },},@@ -443,6 +605,68 @@ export const GRAPH_THEME: GraphTheme = {provenance: { sizeMultiplier: 1.03, borderBoost: 0.14, haloBoost: 0.12, badgeKind: "provenance", badgeVisibleFrom: "inspection" },selected: { sizeMultiplier: 1.06, borderBoost: 0.22, haloBoost: 0.16, badgeVisibleFrom: "overview" },},+ entityShapes: {+ entity: {+ label: "Entity",+ shapeKind: 0,+ aspectRatio: 1,+ fillAlpha: 0.9,+ shellAlpha: 0.14,+ coreScale: 0,+ borderBoost: 0.08,+ minSize: 0,+ },+ biomolecule: {+ label: "Biomolecule",+ shapeKind: 1,+ aspectRatio: 1,+ fillAlpha: 0.9,+ shellAlpha: 0.16,+ coreScale: 0.18,+ borderBoost: 0.16,+ minSize: 1.2,+ },+ condition: {+ label: "Condition",+ shapeKind: 2,+ aspectRatio: 1.04,+ fillAlpha: 0.88,+ shellAlpha: 0.15,+ coreScale: 0.16,+ borderBoost: 0.18,+ minSize: 1.6,+ },+ compound: {+ label: "Compound",+ shapeKind: 3,+ aspectRatio: 1.48,+ fillAlpha: 0.88,+ shellAlpha: 0.15,+ coreScale: 0.14,+ borderBoost: 0.14,+ minSize: 1.4,+ },+ process: {+ label: "Process",+ shapeKind: 4,+ aspectRatio: 1.1,+ fillAlpha: 0.87,+ shellAlpha: 0.14,+ coreScale: 0.14,+ borderBoost: 0.16,+ minSize: 1.4,+ },+ community: {+ label: "Community",+ shapeKind: 5,+ aspectRatio: 1,+ fillAlpha: 0.68,+ shellAlpha: 0.28,+ coreScale: 0.78,+ borderBoost: 0.34,+ minSize: 2,+ },+ },selectedRing: {color: "#E7C57C",width: 1.9,@@ -467,14 +691,14 @@ export const GRAPH_THEME: GraphTheme = {},edges: {states: {- default: { color: "structure", sizeMultiplier: 0.96, minSize: 0.9, zIndex: 0, forceArrow: false, hide: false },- backbone: { color: "backbone", sizeMultiplier: 1.0, minSize: 1.0, zIndex: 1, forceArrow: false, hide: false },- hovered: { color: "hover", sizeMultiplier: 1.6, minSize: 2.2, zIndex: 3, forceArrow: true, hide: false },- selected: { color: "hover", sizeMultiplier: 1.6, minSize: 2.2, zIndex: 3, forceArrow: true, hide: false },- neighbor: { color: "focus", sizeMultiplier: 1.1, minSize: 1.2, zIndex: 1, forceArrow: false, hide: false },- path: { color: "path", sizeMultiplier: 1.7, minSize: 2.4, zIndex: 4, forceArrow: true, hide: false },- inactive: { color: "muted", sizeMultiplier: 0.6, minSize: 0.5, zIndex: 0, forceArrow: false, hide: false },- muted: { color: "muted", sizeMultiplier: 0.6, minSize: 0.5, zIndex: 0, forceArrow: false, hide: false },+ default: { color: "structure", sizeMultiplier: 0.48, minSize: 0.2, zIndex: 0, forceArrow: false, hide: false },+ backbone: { color: "backbone", sizeMultiplier: 0.62, minSize: 0.36, zIndex: 1, forceArrow: false, hide: false },+ hovered: { color: "hover", sizeMultiplier: 1.42, minSize: 1.85, zIndex: 5, forceArrow: true, hide: false },+ selected: { color: "hover", sizeMultiplier: 1.42, minSize: 1.85, zIndex: 5, forceArrow: true, hide: false },+ neighbor: { color: "focus", sizeMultiplier: 0.96, minSize: 0.86, zIndex: 1, forceArrow: false, hide: false },+ path: { color: "path", sizeMultiplier: 1.82, minSize: 2.55, zIndex: 6, forceArrow: true, hide: false },+ inactive: { color: "muted", sizeMultiplier: 0.24, minSize: 0.18, zIndex: 0, forceArrow: false, hide: false },+ muted: { color: "muted", sizeMultiplier: 0.24, minSize: 0.18, zIndex: 0, forceArrow: false, hide: false },},variants: {line: { baseType: "line", arrowPolicy: "hidden", curveStrength: 0, sizeMultiplier: 1, glowAlpha: 0 },@@ -483,8 +707,155 @@ export const GRAPH_THEME: GraphTheme = {parallelCurve: { baseType: "line", arrowPolicy: "contextual", curveStrength: 0.24, sizeMultiplier: 1.1, glowAlpha: 0.12 },pathSignal: { baseType: "arrow", arrowPolicy: "always", curveStrength: 0.16, sizeMultiplier: 1.18, glowAlpha: 0.2 },},- },- overlays: {+ visibility: {+ full: {+ overview: {+ defaultPriorityThreshold: 0.96,+ backgroundSampleRate: 0.035,+ defaultAlpha: 0.026,+ mutedAlpha: 0.012,+ inactiveAlpha: 0.01,+ neighborAlpha: 0.26,+ sizeMultiplier: 0.5,+ hideMuted: true,+ },+ structure: {+ defaultPriorityThreshold: 0.82,+ backgroundSampleRate: 0.16,+ defaultAlpha: 0.04,+ mutedAlpha: 0.014,+ inactiveAlpha: 0.012,+ neighborAlpha: 0.32,+ sizeMultiplier: 0.62,+ hideMuted: true,+ },+ inspection: {+ defaultPriorityThreshold: 0.72,+ backgroundSampleRate: 0.28,+ defaultAlpha: 0.052,+ mutedAlpha: 0.012,+ inactiveAlpha: 0.01,+ neighborAlpha: 0.38,+ sizeMultiplier: 0.64,+ hideMuted: true,+ },+ },+ grouped: {+ overview: {+ defaultPriorityThreshold: 0.42,+ backgroundSampleRate: 1,+ defaultAlpha: 0.18,+ mutedAlpha: 0.06,+ inactiveAlpha: 0.04,+ neighborAlpha: 0.36,+ sizeMultiplier: 0.72,+ hideMuted: false,+ },+ structure: {+ defaultPriorityThreshold: 0.34,+ backgroundSampleRate: 1,+ defaultAlpha: 0.2,+ mutedAlpha: 0.07,+ inactiveAlpha: 0.05,+ neighborAlpha: 0.42,+ sizeMultiplier: 0.78,+ hideMuted: false,+ },+ inspection: {+ defaultPriorityThreshold: 0.28,+ backgroundSampleRate: 1,+ defaultAlpha: 0.22,+ mutedAlpha: 0.08,+ inactiveAlpha: 0.06,+ neighborAlpha: 0.46,+ sizeMultiplier: 0.82,+ hideMuted: false,+ },+ },+ focused: {+ overview: {+ defaultPriorityThreshold: 0.72,+ backgroundSampleRate: 0.7,+ defaultAlpha: 0.1,+ mutedAlpha: 0.03,+ inactiveAlpha: 0.02,+ neighborAlpha: 0.06,+ sizeMultiplier: 0.72,+ hideMuted: true,+ },+ structure: {+ defaultPriorityThreshold: 0.6,+ backgroundSampleRate: 0.8,+ defaultAlpha: 0.12,+ mutedAlpha: 0.035,+ inactiveAlpha: 0.025,+ neighborAlpha: 0.08,+ sizeMultiplier: 0.8,+ hideMuted: true,+ },+ inspection: {+ defaultPriorityThreshold: 0.52,+ backgroundSampleRate: 0.9,+ defaultAlpha: 0.14,+ mutedAlpha: 0.04,+ inactiveAlpha: 0.03,+ neighborAlpha: 0.1,+ sizeMultiplier: 0.88,+ hideMuted: true,+ },+ },+ },+ contextCaps: {+ full: {+ overview: 0,+ structure: 12,+ inspection: 24,+ },+ grouped: {+ overview: 6,+ structure: 8,+ inspection: 10,+ },+ focused: {+ overview: 24,+ structure: 36,+ inspection: 48,+ },+ },+ fullGraphStructure: {+ ambientBackboneAlpha: 0.12,+ backboneAlpha: 0.08,+ bridgeAlpha: 0.14,+ bridgeCurvePriorityThreshold: 0.78,+ bridgeCurveStrength: 0.1,+ backboneMaxSize: 0.5,+ bridgeMaxSize: 0.7,+ structureEdgeAlpha: 0.12,+ inspectionEdgeAlpha: 0.1,+ },+ fullGraphStructureLayer: {+ mode: "off",+ minimumLiteralEdges: 24,+ minimumCurves: 8,+ maxCurves: 64,+ bridgeAlpha: 0.16,+ backboneAlpha: 0.1,+ bridgeLineWidth: 0.9,+ backboneLineWidth: 0.62,+ curveStrength: 0.12,+ },+ },+ interaction: {+ localContextAlpha: 0.32,+ hoverContextAlpha: 0.32,+ selectedEdgeAlpha: 0.6,+ pathEdgeAlpha: 0.76,+ localContextMaxSize: 0.6,+ selectedEdgeMaxSize: 1.0,+ pathEdgeMaxSize: 1.4,+ pathOverlayAlpha: 0.16,+ },+ overlays: {hoverGlowAlpha: 0.18,pathGlowAlpha: 0.16,glowRadiusMultiplier: 4.8,@@ -629,7 +1000,7 @@ export function withAlpha(color: string | undefined, alpha: number): string {}if (color.startsWith("rgba(")) {- return color.replace(/rgba\(([^)]+),\s*[\d.]+\)/, `rgba($1, ${alpha})`);+ return color.replace(/rgba\((.*?),\s*[\d.]+\)/, `rgba($1, ${alpha})`);}if (color.startsWith("rgb(")) {diff --git a/explorer/src/workspaces/GraphWorkspace/scene.ts b/explorer/src/workspaces/GraphWorkspace/scene.tsindex 07dbf515..d6b0c50a 100644--- a/explorer/src/workspaces/GraphWorkspace/scene.ts+++ b/explorer/src/workspaces/GraphWorkspace/scene.ts@@ -7,11 +7,11 @@ import type {GraphCameraState,GraphDisplayMeta,GraphDisplayStateSnapshot,- GraphDiagnosticsSnapshot,GraphEffectsState,GraphInteractionState,GraphLayoutSource,GraphLayoutStatus,+ GraphRuntimeDiagnosticsSnapshot,GraphTemporalState,GraphViewMode,} from "./types";@@ -35,7 +35,7 @@ export interface GraphSceneEventMap {onEdgeSelect?: (edgeId: string) => void;onInteractionStateChange?: (interactionState: GraphInteractionState) => void;onCameraStateChange?: (cameraState: GraphCameraState) => void;- onDiagnosticsChange?: (effectAvailability: GraphDiagnosticsSnapshot["effectAvailability"]) => void;+ onDiagnosticsChange?: (diagnostics: GraphRuntimeDiagnosticsSnapshot) => void;onAnalyticsChange?: (analytics: GraphAnalyticsSnapshot | null) => void;onRuntimeChange?: (runtime: GraphSceneRuntime | null) => void;}diff --git a/explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.ts b/explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.tsindex 657c520e..bb1ad15f 100644--- a/explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.ts+++ b/explorer/src/workspaces/GraphWorkspace/sigmaNativeRendering.ts@@ -5,7 +5,7 @@ import type { NodeDisplayData, RenderParams } from "sigma/types";import { floatColor } from "sigma/utils";import type { NodeHoverDrawingFunction, NodeLabelDrawingFunction } from "sigma/rendering";-import { GRAPH_THEME, withAlpha } from "./graphTheme";+import { GRAPH_THEME, type GraphEntityShapeVariant, withAlpha } from "./graphTheme";type SemanticaNodeDrawData = {x: number;@@ -16,39 +16,106 @@ type SemanticaNodeDrawData = {shellColor?: string;coreScale?: number;borderColor?: string;+ borderSize?: number;ringColor?: string;ringSize?: number;+ entityShape?: GraphEntityShapeVariant;+ entityShapeKind?: number;+ entityAspectRatio?: number;nodeType?: string;};-const MINERAL_DISC_UNIFORMS = ["u_sizeRatio", "u_correctionRatio", "u_matrix"] as const;+const ENTITY_TOKEN_UNIFORMS = ["u_sizeRatio", "u_correctionRatio", "u_matrix"] as const;-const MINERAL_DISC_FRAGMENT_SHADER = /* glsl */ `+const ENTITY_TOKEN_FRAGMENT_SHADER = /* glsl */ `precision highp float;-varying vec4 v_coreColor;-varying vec4 v_shellColor;-varying vec4 v_ringColor;+varying vec4 v_bodyColor;+varying vec4 v_glyphColor;+varying vec4 v_outlineColor;varying vec4 v_color;varying vec2 v_diffVector;varying float v_radius;-varying float v_ringSize;-varying float v_coreScale;+varying float v_outlineSize;+varying float v_glyphScale;+varying float v_shapeKind;+varying float v_aspectRatio;uniform float u_correctionRatio;const float bias = 255.0 / 254.0;const vec4 transparent = vec4(0.0, 0.0, 0.0, 0.0);-float discMetric(vec2 point) {- return length(point);+float hexMetric(vec2 point) {+ vec2 q = abs(point);+ return max(q.y, q.x * 0.8660254 + q.y * 0.5);+}++vec2 rotate45(vec2 point) {+ const float invSqrt2 = 0.70710678;+ return vec2(+ (point.x - point.y) * invSqrt2,+ (point.x + point.y) * invSqrt2+ );+}++float roundedBoxDistance(vec2 point, vec2 halfSize, float radius) {+ vec2 q = abs(point) - halfSize + vec2(radius);+ return length(max(q, 0.0)) + min(max(q.x, q.y), 0.0) - radius;+}++float capsuleDistance(vec2 point) {+ vec2 q = vec2(max(abs(point.x) - 0.44, 0.0), point.y);+ return length(q) - 0.56;+}++float shapeDistance(vec2 point, float shapeKind) {+ if (shapeKind < 0.5) {+ return length(point) - 1.0;+ }+ if (shapeKind < 1.5) {+ return hexMetric(point) - 0.92;+ }+ if (shapeKind < 2.5) {+ return roundedBoxDistance(rotate45(point), vec2(0.58, 0.58), 0.18);+ }+ if (shapeKind < 3.5) {+ return capsuleDistance(point);+ }+ if (shapeKind < 4.5) {+ return roundedBoxDistance(point, vec2(0.78, 0.78), 0.24);+ }+ return length(point) - 1.0;+}++float glyphDistance(vec2 point, float shapeKind, float scale) {+ vec2 scaled = point / max(scale, 0.08);+ if (shapeKind < 0.5) {+ return 1.0;+ }+ if (shapeKind < 1.5) {+ return abs(hexMetric(scaled) - 0.74) - 0.055;+ }+ if (shapeKind < 2.5) {+ return abs(abs(scaled.x) + abs(scaled.y) - 0.78) - 0.045;+ }+ if (shapeKind < 3.5) {+ return roundedBoxDistance(scaled, vec2(0.56, 0.07), 0.07);+ }+ if (shapeKind < 4.5) {+ return abs(roundedBoxDistance(scaled, vec2(0.48, 0.48), 0.18)) - 0.045;+ }+ return 1.0;}void main(void) {- vec2 unit = v_diffVector / max(v_radius, 0.0001);- float metric = discMetric(unit);+ vec2 unit = vec2(+ v_diffVector.x / max(v_radius * v_aspectRatio, 0.0001),+ v_diffVector.y / max(v_radius, 0.0001)+ );float aa = (2.4 * u_correctionRatio) / max(v_radius, 1.0);- float alpha = 1.0 - smoothstep(1.0 - aa, 1.0 + aa, metric);+ float distance = shapeDistance(unit, v_shapeKind);+ float alpha = 1.0 - smoothstep(-aa, aa, distance);#ifdef PICKING_MODEif (alpha <= 0.0) {@@ -63,52 +130,63 @@ void main(void) {return;}- float ringNorm = clamp(v_ringSize / max(v_radius, 1.0), 0.0, 0.45);- float ringStart = max(0.0, 1.0 - ringNorm);- float coreEdge = clamp(v_coreScale, 0.06, 0.78);- float coreBlend = 1.0 - smoothstep(max(coreEdge - 0.14, 0.0), coreEdge, metric);- float bodyLight = 1.0 - smoothstep(0.0, 0.82, metric);- vec4 color = mix(v_shellColor, v_coreColor, coreBlend);- color.rgb += vec3(0.022) * pow(bodyLight, 1.45);+ float outlineNorm = clamp(v_outlineSize / max(v_radius, 1.0), 0.035, 0.28);+ float outlineBlend = 1.0 - smoothstep(-outlineNorm - aa, -outlineNorm + aa, distance);+ float isOutline = 1.0 - outlineBlend;+ float topLight = clamp((-unit.y + 0.85) * 0.5, 0.0, 1.0);+ vec4 color = v_bodyColor;+ color.rgb += vec3(0.014) * pow(topLight, 2.2);- if (ringNorm > 0.0 && metric >= ringStart) {- color = v_ringColor;+ if (isOutline > 0.0) {+ color = mix(color, v_outlineColor, isOutline);}++ float glyphVisible = step(7.25, v_radius) * step(0.13, v_glyphScale) * step(0.5, v_shapeKind) * (1.0 - step(4.5, v_shapeKind));+ float glyph = (1.0 - smoothstep(-aa * 1.4, aa * 1.4, glyphDistance(unit, v_shapeKind, clamp(v_glyphScale, 0.16, 0.52)))) * glyphVisible;+ if (glyph > 0.0 && distance < -outlineNorm) {+ color = mix(color, v_glyphColor, glyph * 0.38);+ }+color.a *= alpha;gl_FragColor = color;#endif}`;-const MINERAL_DISC_VERTEX_SHADER = /* glsl */ `+const ENTITY_TOKEN_VERTEX_SHADER = /* glsl */ `attribute vec4 a_id;attribute vec2 a_position;attribute float a_size;attribute float a_angle;-attribute vec4 a_coreColor;-attribute vec4 a_shellColor;-attribute vec4 a_ringColor;-attribute float a_ringSize;-attribute float a_coreScale;+attribute vec4 a_bodyColor;+attribute vec4 a_glyphColor;+attribute vec4 a_outlineColor;+attribute float a_outlineSize;+attribute float a_glyphScale;+attribute float a_shapeKind;+attribute float a_aspectRatio;uniform mat3 u_matrix;uniform float u_sizeRatio;uniform float u_correctionRatio;-varying vec4 v_coreColor;-varying vec4 v_shellColor;-varying vec4 v_ringColor;+varying vec4 v_bodyColor;+varying vec4 v_glyphColor;+varying vec4 v_outlineColor;varying vec4 v_color;varying vec2 v_diffVector;varying float v_radius;-varying float v_ringSize;-varying float v_coreScale;+varying float v_outlineSize;+varying float v_glyphScale;+varying float v_shapeKind;+varying float v_aspectRatio;const float bias = 255.0 / 254.0;void main() {float size = a_size * u_correctionRatio / u_sizeRatio * 4.0;- vec2 diffVector = size * vec2(cos(a_angle), sin(a_angle));+ float aspect = max(a_aspectRatio, 1.0);+ vec2 diffVector = size * vec2(cos(a_angle) * aspect, sin(a_angle));vec2 position = a_position + diffVector;gl_Position = vec4(@@ -119,22 +197,24 @@ void main() {v_diffVector = diffVector;v_radius = size / 2.0;- v_ringSize = a_ringSize;- v_coreScale = a_coreScale;+ v_outlineSize = a_outlineSize;+ v_glyphScale = a_glyphScale;+ v_shapeKind = a_shapeKind;+ v_aspectRatio = aspect;#ifdef PICKING_MODEv_color = a_id;#else- v_coreColor = a_coreColor;- v_shellColor = a_shellColor;- v_ringColor = a_ringColor;+ v_bodyColor = a_bodyColor;+ v_glyphColor = a_glyphColor;+ v_outlineColor = a_outlineColor;#endifv_color.a *= bias;}`;-class MineralDiscNodeProgram extends NodeProgram<(typeof MINERAL_DISC_UNIFORMS)[number]> {+class EntityTokenNodeProgram extends NodeProgram<(typeof ENTITY_TOKEN_UNIFORMS)[number]> {static readonly ANGLE_1 = 0;static readonly ANGLE_2 = (2 * Math.PI) / 3;static readonly ANGLE_3 = (4 * Math.PI) / 3;@@ -146,47 +226,52 @@ class MineralDiscNodeProgram extends NodeProgram<(typeof MINERAL_DISC_UNIFORMS)[getDefinition() {return {VERTICES: 3,- VERTEX_SHADER_SOURCE: MINERAL_DISC_VERTEX_SHADER,- FRAGMENT_SHADER_SOURCE: MINERAL_DISC_FRAGMENT_SHADER,+ VERTEX_SHADER_SOURCE: ENTITY_TOKEN_VERTEX_SHADER,+ FRAGMENT_SHADER_SOURCE: ENTITY_TOKEN_FRAGMENT_SHADER,METHOD: WebGLRenderingContext.TRIANGLES,- UNIFORMS: MINERAL_DISC_UNIFORMS,+ UNIFORMS: ENTITY_TOKEN_UNIFORMS,ATTRIBUTES: [{ name: "a_position", size: 2, type: WebGLRenderingContext.FLOAT },{ name: "a_size", size: 1, type: WebGLRenderingContext.FLOAT },- { name: "a_coreColor", size: 4, type: WebGLRenderingContext.UNSIGNED_BYTE, normalized: true },- { name: "a_shellColor", size: 4, type: WebGLRenderingContext.UNSIGNED_BYTE, normalized: true },- { name: "a_ringColor", size: 4, type: WebGLRenderingContext.UNSIGNED_BYTE, normalized: true },- { name: "a_ringSize", size: 1, type: WebGLRenderingContext.FLOAT },- { name: "a_coreScale", size: 1, type: WebGLRenderingContext.FLOAT },+ { name: "a_bodyColor", size: 4, type: WebGLRenderingContext.UNSIGNED_BYTE, normalized: true },+ { name: "a_glyphColor", size: 4, type: WebGLRenderingContext.UNSIGNED_BYTE, normalized: true },+ { name: "a_outlineColor", size: 4, type: WebGLRenderingContext.UNSIGNED_BYTE, normalized: true },+ { name: "a_outlineSize", size: 1, type: WebGLRenderingContext.FLOAT },+ { name: "a_glyphScale", size: 1, type: WebGLRenderingContext.FLOAT },+ { name: "a_shapeKind", size: 1, type: WebGLRenderingContext.FLOAT },+ { name: "a_aspectRatio", size: 1, type: WebGLRenderingContext.FLOAT },{ name: "a_id", size: 4, type: WebGLRenderingContext.UNSIGNED_BYTE, normalized: true },],CONSTANT_ATTRIBUTES: [{ name: "a_angle", size: 1, type: WebGLRenderingContext.FLOAT },],CONSTANT_DATA: [- [MineralDiscNodeProgram.ANGLE_1],- [MineralDiscNodeProgram.ANGLE_2],- [MineralDiscNodeProgram.ANGLE_3],+ [EntityTokenNodeProgram.ANGLE_1],+ [EntityTokenNodeProgram.ANGLE_2],+ [EntityTokenNodeProgram.ANGLE_3],],};}processVisibleItem(nodeIndex: number, startIndex: number, data: NodeDisplayData & SemanticaNodeDrawData): void {const array = this.array;- const ringColor = resolveAccentBorderColor(data.ringSize, data.ringColor, data.borderColor, GRAPH_THEME.nodes.selectedRing.color);+ const outlineColor = resolveAccentBorderColor(data.ringSize, data.ringColor, data.borderColor, GRAPH_THEME.nodes.selectedRing.color);+ const outlineSize = Math.max(data.ringSize || 0, data.borderSize || 0.7);array[startIndex++] = data.x;array[startIndex++] = data.y;array[startIndex++] = data.size;array[startIndex++] = floatColor(data.color || GRAPH_THEME.palette.overview.nodeCore);- array[startIndex++] = floatColor(data.shellColor || withAlpha(GRAPH_THEME.palette.overview.nodeBase, GRAPH_THEME.palette.overview.nodeShellAlpha));- array[startIndex++] = floatColor(ringColor);- array[startIndex++] = data.ringSize || 0;+ array[startIndex++] = floatColor(data.shellColor || withAlpha(GRAPH_THEME.palette.overview.nodeBase, 0.58));+ array[startIndex++] = floatColor(outlineColor);+ array[startIndex++] = outlineSize;array[startIndex++] = data.coreScale ?? 0.22;+ array[startIndex++] = data.entityShapeKind ?? GRAPH_THEME.nodes.entityShapes[data.entityShape || "entity"].shapeKind;+ array[startIndex++] = data.entityAspectRatio ?? GRAPH_THEME.nodes.entityShapes[data.entityShape || "entity"].aspectRatio;array[startIndex++] = nodeIndex;}- setUniforms(params: RenderParams, { gl, uniformLocations }: ProgramInfo<(typeof MINERAL_DISC_UNIFORMS)[number]>): void {+ setUniforms(params: RenderParams, { gl, uniformLocations }: ProgramInfo<(typeof ENTITY_TOKEN_UNIFORMS)[number]>): void {gl.uniform1f(uniformLocations.u_correctionRatio, params.correctionRatio);gl.uniform1f(uniformLocations.u_sizeRatio, params.sizeRatio);gl.uniformMatrix3fv(uniformLocations.u_matrix, false, params.matrix);@@ -326,7 +411,7 @@ export const drawSemanticaNodeHover: NodeHoverDrawingFunction = (context, rawDatexport const SEMANTICA_NODE_PROGRAM_CLASSES = {...DEFAULT_NODE_PROGRAM_CLASSES,- circle: MineralDiscNodeProgram,+ circle: EntityTokenNodeProgram,};export const SEMANTICA_EDGE_PROGRAM_CLASSES = {diff --git a/explorer/src/workspaces/GraphWorkspace/types.ts b/explorer/src/workspaces/GraphWorkspace/types.tsindex ecb5bbf2..594ce7e2 100644--- a/explorer/src/workspaces/GraphWorkspace/types.ts+++ b/explorer/src/workspaces/GraphWorkspace/types.ts@@ -12,6 +12,7 @@ export type GraphLoadPhase =export type GraphLoadProgressKind = "determinate" | "indeterminate";export type GraphNodeInteractionState = "default" | "hovered" | "selected" | "neighbor" | "path" | "inactive" | "muted";export type GraphEdgeInteractionState = "default" | "backbone" | "hovered" | "selected" | "neighbor" | "path" | "inactive" | "muted";+export type GraphFullEdgeClass = "hidden" | "backbone" | "bridge" | "local-context" | "selected" | "path" | "muted";export type GraphSelectedNodeKind = "none" | "base" | "grouped" | "unavailable";export interface GraphCameraState {@@ -92,11 +93,49 @@ export interface GraphEffectAvailability {segmentCap?: number;}+export type GraphFullEdgeClassCounts = Record<GraphFullEdgeClass, number>;++export interface GraphFullEdgeClassDiagnostics {+ mode: GraphViewMode;+ zoomTier: GraphInteractionState["zoomTier"];+ totalEdges: number;+ visibleEdges: number;+ counts: GraphFullEdgeClassCounts;+ updatedAt: number;+}++export type GraphStructureLayerDisabledReason =+ | "non-full-mode"+ | "layout-running"+ | "enough-literal-edges"+ | "no-eligible-edges"+ | "invalid-layer"+ | "cache-empty"+ | "disabled";++export interface GraphStructureLayerDiagnostics {+ enabled: boolean;+ disabledReason: GraphStructureLayerDisabledReason | null;+ curveCount: number;+ bridgeCurveCount: number;+ backboneCurveCount: number;+ cacheKey: string;+ lastDrawAt: number | null;+}++export interface GraphRuntimeDiagnosticsSnapshot {+ effectAvailability: GraphDiagnosticsSnapshot["effectAvailability"];+ edgeClasses?: GraphFullEdgeClassDiagnostics;+ structureLayer?: GraphStructureLayerDiagnostics;+}+export interface GraphDiagnosticsSnapshot {interactionState: GraphInteractionState;activePluginIds: string[];openPanelIds: string[];effectsState: GraphEffectsState;+ edgeClasses?: GraphFullEdgeClassDiagnostics;+ structureLayer?: GraphStructureLayerDiagnostics;effectAvailability: {pathPulse: GraphEffectAvailability;pathFlow: GraphEffectAvailability;diff --git a/explorer/src/workspaces/GraphWorkspace/useLoadGraph.ts b/explorer/src/workspaces/GraphWorkspace/useLoadGraph.tsindex fffa6773..02214e85 100644--- a/explorer/src/workspaces/GraphWorkspace/useLoadGraph.ts+++ b/explorer/src/workspaces/GraphWorkspace/useLoadGraph.ts@@ -10,6 +10,7 @@ import {withAlpha,type GraphBadgeKind,type GraphEdgeVariant,+ type GraphEntityShapeVariant,type GraphLabelVisibilityPolicy,type GraphNodeShapeVariant,} from "./graphTheme";@@ -29,6 +30,12 @@ const SEMANTIC_COLOR_FIELDS = [] as const;const PROVENANCE_KEYS = ["source", "source_url", "pmid", "pmids", "evidence", "provenance", "confidence"] as const;+const ENTITY_SHAPE_ALIASES: Array<[GraphEntityShapeVariant, RegExp]> = [+ ["biomolecule", /\b(gene|protein|enzyme|receptor|target|transcript|rna|dna|mirna|biomolecule|peptide)\b/i],+ ["condition", /\b(disease|condition|phenotype|symptom|disorder|syndrome|diagnosis|pathology|trait)\b/i],+ ["compound", /\b(drug|chemical|compound|metabolite|molecule|small[_\s-]?molecule|ligand|therapeutic|medication|substance)\b/i],+ ["process", /\b(pathway|process|mechanism|function|ontology|biological[_\s-]?process|cellular[_\s-]?process|program|module)\b/i],+];function getSemanticFieldValue(attributes: NodeAttributes, field: (typeof SEMANTIC_COLOR_FIELDS)[number]): string | null {if (field === "nodeType") {@@ -196,6 +203,27 @@ function getProvenanceCount(properties: Record<string, unknown>): number {);}+function resolveEntityShape(attributes: NodeAttributes, semanticGroup: string): GraphEntityShapeVariant {+ const values = [+ attributes.nodeType,+ semanticGroup,+ attributes.content,+ String(attributes.properties?.type ?? ""),+ String(attributes.properties?.category ?? ""),+ String(attributes.properties?.label ?? ""),+ ]+ .filter((value) => typeof value === "string" && value.trim().length > 0)+ .join(" ");++ for (const [shape, pattern] of ENTITY_SHAPE_ALIASES) {+ if (pattern.test(values)) {+ return shape;+ }+ }++ return "entity";+}+function resolveNodeVariantMetadata(baseColor: string,sizeRatio: number,@@ -548,6 +576,7 @@ export function useLoadGraph(options: UseLoadGraphOptions = {}) {const hasTemporalBounds = Boolean(attributes.valid_from || attributes.valid_until);const provenanceCount = getProvenanceCount(attributes.properties ?? {});const properties = attributes.properties as Record<string, unknown>;+ const entityShape = resolveEntityShape(attributes, semanticGroup);const providedX = readFiniteCoordinate(properties?.x);const providedY = readFiniteCoordinate(properties?.y);const seededPosition = seededPositions?.get(id);@@ -575,6 +604,7 @@ export function useLoadGraph(options: UseLoadGraphOptions = {}) {strokeColor: darkenHex(baseColor, 112),borderColor: darkenHex(baseColor, 112),borderSize: 0.72,+ entityShape,...resolveNodeVariantMetadata(baseColor, sizeRatio, hasTemporalBounds, provenanceCount),} as NodeAttributes,};@@ -598,6 +628,12 @@ export function useLoadGraph(options: UseLoadGraphOptions = {}) {const parallelIndex = parallelOffsets.get(pairKey) ?? 0;parallelOffsets.set(pairKey, parallelIndex + 1);const parallelCount = parallelCounts.get(pairKey) ?? 1;+ const normalizedWeight = clamp(0, Math.log1p(Math.max(Number(edge.weight) || 1, 1)) / 6, 1);+ const edgeVisualPriority = clamp(+ 0,+ Math.sqrt(Math.max(sourcePriority, 0) * Math.max(targetPriority, 0)) * 0.72 + normalizedWeight * 0.28,+ 1,+ );return {id: edge.id,@@ -617,7 +653,7 @@ export function useLoadGraph(options: UseLoadGraphOptions = {}) {color: GRAPH_THEME.palette.muted.edgeStructure,baseColor: GRAPH_THEME.palette.muted.edgeStructure,mutedColor: GRAPH_THEME.palette.muted.edgeOverview,- visualPriority: Math.max(sourcePriority, targetPriority),+ visualPriority: edgeVisualPriority,isBidirectional,edgeFamily: isBidirectional ? "bidirectional" : "line",curveGroup: curveGroupForPair(edge.source, edge.target),diff --git a/explorer/tests/graphSceneState.display.test.ts b/explorer/tests/graphSceneState.display.test.tsindex 5639939e..7832a907 100644--- a/explorer/tests/graphSceneState.display.test.ts+++ b/explorer/tests/graphSceneState.display.test.ts@@ -5,13 +5,28 @@ import {batchMergeEdges,batchMergeNodes,clearGraph,+ graph,} from "../src/store/graphStore.ts";import {+ buildGraphAnalyticsSnapshot,+ computeGraphAnalyticsBase,+} from "../src/workspaces/GraphWorkspace/graphAnalytics.ts";+import {+ classifyFullGraphEdge,checkGroupedViewAvailability,+ mapFullEdgeClassToVisualState,+ resolveEdgeElementStyle,+ resolveEdgeVisualState,resolveDisplayGraph,resolveGroupedDisplayNodeId,resolveGroupedDisplayStateSnapshot,} from "../src/workspaces/GraphWorkspace/graphSceneState.ts";+import {+ buildGraphStructureCurveCache,+ evaluateGraphStructureLayerGate,+} from "../src/workspaces/GraphWorkspace/graphStructureLayer.ts";+import { GRAPH_THEME } from "../src/workspaces/GraphWorkspace/graphTheme.ts";+import type { GraphFullEdgeClass, GraphFullEdgeClassCounts } from "../src/workspaces/GraphWorkspace/types.ts";function addNode(id: string, semanticGroup = "entity") {batchMergeNodes([@@ -33,6 +48,10 @@ function addNode(id: string, semanticGroup = "entity") {]);}+function setNodePosition(id: string, x: number, y: number) {+ graph.mergeNodeAttributes(id, { x, y });+}+function addEdge(id: string, source: string, target: string, weight = 1) {batchMergeEdges([{@@ -56,6 +75,510 @@ test.after(() => {clearGraph();});+test("resolveEdgeVisualState caps selected-node incident edge promotion", () => {+ const uncappedState = resolveEdgeVisualState(+ "edge-1",+ "hub",+ "leaf",+ "inspection",+ null,+ "hub",+ "",+ new Set(["hub", "leaf"]),+ new Set(),+ new Set(),+ );+ assert.equal(uncappedState, "muted");++ const cappedState = resolveEdgeVisualState(+ "edge-1",+ "hub",+ "leaf",+ "inspection",+ null,+ "hub",+ "",+ new Set(["hub", "leaf"]),+ new Set(),+ new Set(["edge-1"]),+ );+ assert.equal(cappedState, "selected");+});++test("resolveEdgeElementStyle applies full-graph LOD to directional background edges", () => {+ const style = resolveEdgeElementStyle(+ GRAPH_THEME,+ "overview",+ "default",+ {+ edgeType: "related_to",+ weight: 1,+ properties: {},+ edgeVariant: "directional",+ visualPriority: 0.1,+ baseSize: 0.5,+ },+ "source",+ "target",+ "full",+ "directional-low-priority",+ );++ assert.equal(style.hidden, true);+});++test("classifyFullGraphEdge applies deterministic priority order", () => {+ const edgeClass = classifyFullGraphEdge(+ "edge-priority",+ "source",+ "target",+ "inspection",+ "source",+ "source",+ "edge-priority",+ new Set(["source", "target"]),+ new Set(["edge-priority"]),+ new Set(["edge-priority"]),+ new Set(["edge-priority"]),+ { label: "source", x: 0, y: 0, size: 1, color: "#fff", nodeType: "gene", content: "source", semanticGroup: "gene", properties: {} },+ { label: "target", x: 0, y: 0, size: 1, color: "#fff", nodeType: "disease", content: "target", semanticGroup: "disease", properties: {} },+ );++ assert.equal(edgeClass, "path");++ const selectedClass = classifyFullGraphEdge(+ "edge-priority",+ "source",+ "target",+ "inspection",+ "source",+ "source",+ "edge-priority",+ new Set(["source", "target"]),+ new Set(),+ new Set(["edge-priority"]),+ );++ assert.equal(selectedClass, "selected");+});++test("classifyFullGraphEdge separates capped local context from muted hub edges", () => {+ const mutedClass = classifyFullGraphEdge(+ "hub-edge",+ "hub",+ "leaf",+ "inspection",+ null,+ "hub",+ "",+ new Set(["hub", "leaf"]),+ new Set(),+ new Set(),+ );++ assert.equal(mutedClass, "muted");++ const localContextClass = classifyFullGraphEdge(+ "hub-edge",+ "hub",+ "leaf",+ "inspection",+ null,+ "hub",+ "",+ new Set(["hub", "leaf"]),+ new Set(),+ new Set(["hub-edge"]),+ );++ assert.equal(localContextClass, "local-context");+});++test("classifyFullGraphEdge marks curated bridge and backbone candidates", () => {+ const bridgeClass = classifyFullGraphEdge(+ "curated-bridge",+ "source",+ "target",+ "overview",+ null,+ "",+ "",+ new Set(),+ new Set(),+ new Set(),+ new Set(["curated-bridge"]),+ { label: "source", x: 0, y: 0, size: 1, color: "#fff", nodeType: "gene", content: "source", semanticGroup: "gene", properties: {} },+ { label: "target", x: 0, y: 0, size: 1, color: "#fff", nodeType: "disease", content: "target", semanticGroup: "disease", properties: {} },+ );++ assert.equal(bridgeClass, "bridge");++ const backboneClass = classifyFullGraphEdge(+ "curated-backbone",+ "source",+ "target",+ "overview",+ null,+ "",+ "",+ new Set(),+ new Set(),+ new Set(),+ new Set(["curated-backbone"]),+ { label: "source", x: 0, y: 0, size: 1, color: "#fff", nodeType: "gene", content: "source", semanticGroup: "gene", properties: {} },+ { label: "target", x: 0, y: 0, size: 1, color: "#fff", nodeType: "gene", content: "target", semanticGroup: "gene", properties: {} },+ );++ assert.equal(backboneClass, "backbone");+});++test("classifyFullGraphEdge hides ordinary full-graph overview edges", () => {+ const edgeClass = classifyFullGraphEdge(+ "ordinary-edge",+ "source",+ "target",+ "overview",+ null,+ "",+ "",+ new Set(),+ new Set(),+ new Set(),+ );++ assert.equal(edgeClass, "hidden");+});++test("mapFullEdgeClassToVisualState renders curated backbone and bridge as backbone", () => {+ assert.equal(+ mapFullEdgeClassToVisualState("backbone", { hoveredNodeId: null, hasActiveInteraction: false }),+ "backbone",+ );+ assert.equal(+ mapFullEdgeClassToVisualState("bridge", { hoveredNodeId: null, hasActiveInteraction: false }),+ "backbone",+ );+ assert.equal(+ mapFullEdgeClassToVisualState("hidden", { hoveredNodeId: null, hasActiveInteraction: false }),+ "inactive",+ );+});++test("resolveEdgeElementStyle renders curated full-graph backbone quietly", () => {+ const style = resolveEdgeElementStyle(+ GRAPH_THEME,+ "overview",+ "backbone",+ {+ edgeType: "related_to",+ weight: 2,+ properties: {},+ visualPriority: 0.9,+ baseSize: 0.8,+ },+ "source",+ "target",+ "full",+ "curated-backbone-edge",+ "backbone",+ );++ assert.equal(style.hidden, false);+ assert.equal(style.type, "line");+ assert.match(style.color ?? "", /rgba\(.+,\s*0\.08\)/);+ assert.ok(Number(style.size ?? 0) <= GRAPH_THEME.edges.fullGraphStructure.backboneMaxSize);+});++test("resolveEdgeElementStyle renders high-value bridge as a calm curved teal edge", () => {+ const style = resolveEdgeElementStyle(+ GRAPH_THEME,+ "overview",+ "backbone",+ {+ edgeType: "related_to",+ weight: 4,+ properties: {},+ visualPriority: 0.95,+ baseSize: 0.9,+ edgeVariant: "line",+ },+ "source",+ "target",+ "full",+ "curated-bridge-edge",+ "bridge",+ );++ assert.equal(style.hidden, false);+ assert.equal(style.type, "curve");+ assert.notEqual(style.type, "arrow");+ assert.match(style.color ?? "", /rgba\(.+,\s*0\.14\)/);+ assert.equal(style.curvature, GRAPH_THEME.edges.fullGraphStructure.bridgeCurveStrength);+ assert.ok(Number(style.size ?? 0) <= GRAPH_THEME.edges.fullGraphStructure.bridgeMaxSize);+});++test("resolveEdgeElementStyle keeps low-priority bridge straight", () => {+ const style = resolveEdgeElementStyle(+ GRAPH_THEME,+ "overview",+ "backbone",+ {+ edgeType: "related_to",+ weight: 1,+ properties: {},+ visualPriority: 0.2,+ baseSize: 0.9,+ edgeVariant: "line",+ },+ "source",+ "target",+ "full",+ "low-value-bridge-edge",+ "bridge",+ );++ assert.equal(style.hidden, false);+ assert.equal(style.type, "line");+ assert.equal(style.curvature, 0);+});++test("evaluateGraphStructureLayerGate enables only sparse settled full-graph structure", () => {+ const counts: GraphFullEdgeClassCounts = {+ hidden: 20,+ backbone: 6,+ bridge: 4,+ "local-context": 0,+ selected: 0,+ path: 0,+ muted: 0,+ };++ assert.deepEqual(+ evaluateGraphStructureLayerGate({+ mode: "auto",+ viewMode: "grouped",+ isLayoutRunning: false,+ edgeDiagnostics: {+ mode: "grouped",+ zoomTier: "overview",+ totalEdges: 30,+ visibleEdges: 10,+ counts,+ updatedAt: 1,+ },+ minimumLiteralEdges: 24,+ }),+ { enabled: false, disabledReason: "non-full-mode" },+ );++ assert.deepEqual(+ evaluateGraphStructureLayerGate({+ mode: "auto",+ viewMode: "full",+ isLayoutRunning: true,+ edgeDiagnostics: {+ mode: "full",+ zoomTier: "overview",+ totalEdges: 30,+ visibleEdges: 10,+ counts,+ updatedAt: 1,+ },+ minimumLiteralEdges: 24,+ }),+ { enabled: false, disabledReason: "layout-running" },+ );++ assert.deepEqual(+ evaluateGraphStructureLayerGate({+ mode: "auto",+ viewMode: "full",+ isLayoutRunning: false,+ edgeDiagnostics: {+ mode: "full",+ zoomTier: "overview",+ totalEdges: 30,+ visibleEdges: 24,+ counts: { ...counts, backbone: 18, bridge: 6 },+ updatedAt: 1,+ },+ minimumLiteralEdges: 24,+ }),+ { enabled: false, disabledReason: "enough-literal-edges" },+ );++ assert.deepEqual(+ evaluateGraphStructureLayerGate({+ mode: "auto",+ viewMode: "full",+ isLayoutRunning: false,+ edgeDiagnostics: {+ mode: "full",+ zoomTier: "overview",+ totalEdges: 30,+ visibleEdges: 10,+ counts,+ updatedAt: 1,+ },+ minimumLiteralEdges: 24,+ }),+ { enabled: true, disabledReason: null },+ );+});++test("buildGraphStructureCurveCache prefers bridges, caps curves, and skips invalid endpoints", () => {+ addNode("a", "gene");+ addNode("b", "disease");+ addNode("c", "gene");+ addNode("d", "compound");+ setNodePosition("a", 0, 0);+ setNodePosition("b", 100, 0);+ setNodePosition("c", 0, 100);+ setNodePosition("d", Number.NaN, 100);++ addEdge("backbone-1", "a", "c", 1);+ graph.mergeEdgeAttributes("backbone-1", { visualPriority: 1 });+ addEdge("bridge-1", "a", "b", 0.2);+ graph.mergeEdgeAttributes("bridge-1", { visualPriority: 0.1 });+ addEdge("selected-1", "b", "c", 1);+ graph.mergeEdgeAttributes("selected-1", { visualPriority: 1 });+ addEdge("invalid-bridge", "a", "d", 1);+ graph.mergeEdgeAttributes("invalid-bridge", { visualPriority: 1 });++ const edgeClasses = new Map<string, GraphFullEdgeClass>([+ ["backbone-1", "backbone"],+ ["bridge-1", "bridge"],+ ["selected-1", "selected"],+ ["invalid-bridge", "bridge"],+ ]);++ const capped = buildGraphStructureCurveCache({+ graphRef: graph,+ cacheKey: "test-cache",+ classifyEdge: (edgeId) => edgeClasses.get(edgeId) ?? "hidden",+ maxCurves: 1,+ curveStrength: 0.12,+ });++ assert.equal(capped.curves.length, 1);+ assert.equal(capped.curves[0].edgeId, "bridge-1");+ assert.equal(capped.bridgeCurveCount, 1);+ assert.equal(capped.backboneCurveCount, 0);++ const uncapped = buildGraphStructureCurveCache({+ graphRef: graph,+ cacheKey: "test-cache-all",+ classifyEdge: (edgeId) => edgeClasses.get(edgeId) ?? "hidden",+ maxCurves: 10,+ curveStrength: 0.12,+ });++ assert.deepEqual(+ uncapped.curves.map((curve) => curve.edgeId).sort(),+ ["backbone-1", "bridge-1"],+ );+});++test("resolveEdgeVisualState suppresses automatic overview backbone in clean baseline", () => {+ const state = resolveEdgeVisualState(+ "overview-backbone-high-priority",+ "source",+ "target",+ "overview",+ null,+ "",+ "",+ new Set(),+ new Set(),+ );++ assert.equal(state, "inactive");+});++test("resolveEdgeElementStyle keeps full-graph selected and path edges controlled", () => {+ const selectedStyle = resolveEdgeElementStyle(+ GRAPH_THEME,+ "inspection",+ "selected",+ {+ edgeType: "related_to",+ weight: 2,+ properties: {},+ visualPriority: 0.9,+ baseSize: 0.8,+ },+ "source",+ "target",+ "full",+ "selected-context-edge",+ );+ const pathStyle = resolveEdgeElementStyle(+ GRAPH_THEME,+ "inspection",+ "path",+ {+ edgeType: "causes",+ weight: 2,+ properties: {},+ visualPriority: 0.9,+ baseSize: 0.8,+ },+ "source",+ "target",+ "full",+ "path-context-edge",+ );++ assert.equal(selectedStyle.hidden, false);+ assert.match(selectedStyle.color ?? "", /rgba\(.+,\s*0\.6\)/);+ assert.equal(pathStyle.hidden, false);+ assert.match(pathStyle.color ?? "", /rgba\(.+,\s*0\.76\)/);+});++test("buildGraphAnalyticsSnapshot emits a readable capped overview backbone", () => {+ const semanticGroups = ["gene/protein", "disease", "drug", "pathway"];+ for (let index = 0; index < 16; index += 1) {+ addNode(`n${index}`, semanticGroups[index % semanticGroups.length]);+ }++ let edgeIndex = 0;+ for (let sourceIndex = 0; sourceIndex < 16; sourceIndex += 1) {+ for (let offset = 1; offset <= 3; offset += 1) {+ const targetIndex = (sourceIndex + offset * 3) % 16;+ if (sourceIndex === targetIndex) {+ continue;+ }+ addEdge(`ambient-edge-${edgeIndex}`, `n${sourceIndex}`, `n${targetIndex}`, 1 + (edgeIndex % 5));+ edgeIndex += 1;+ }+ }++ const base = computeGraphAnalyticsBase(graph, {+ computeCommunities: false,+ computeCentrality: true,+ });+ const analytics = buildGraphAnalyticsSnapshot({+ graphRef: graph,+ interactionState: {+ hoveredNodeId: null,+ selectedNodeId: "",+ selectedEdgeId: "",+ focusedNodeId: "",+ activePath: [],+ activePathEdgeIds: [],+ viewMode: "full",+ zoomTier: "overview",+ isLayoutRunning: false,+ },+ base,+ visibleNodeIds: graph.nodes(),+ });++ assert.equal(analytics.overviewBackbone.ready, true);+ assert.ok(analytics.overviewBackbone.edgeIds.length > 6);+ assert.ok(analytics.overviewBackbone.edgeIds.length <= 128);+});+test("resolveDisplayGraph bundles parallel edges in full view", () => {addNode("a");addNode("b");@@ -257,3 +780,4 @@ test("checkGroupedViewAvailability returns available when communities exist", ()assert.equal(result.available, true);assert.equal(result.reason, null);});+