Repository Public
1// SP Notes Core2// File: Sources/SPNotesFeatures/Knowledge/GraphCanvasView.swift3// Description: The drawing of a graph with SwiftUI `Canvas`: edges that draw themselves (signature motion « Knowledge4// Connections », complete at once under Reduce Motion), nodes sized by degree and coloured by kind, labels,5// and the pan / zoom / tap gestures forwarded to the model.6//7// Author: Simon-Pierre Boucher8// Contact: contact@spboucher.ai9import SPNotesAPI10import SPNotesDesign11import SwiftUI1213/// What the canvas needs to draw one frame (value type: the drawing never touches the model).14struct GraphScene: Equatable {15 struct Node: Equatable {16 var id: String17 var position: CGPoint // unit box18 var radius: CGFloat19 var kind: String20 var isAI: Bool21 var label: String22 var showsLabel: Bool23 }2425 struct Edge: Equatable {26 var id: String27 var source: String28 var target: String29 var from: CGPoint30 var to: CGPoint31 var isAI: Bool32 var isSuggestion: Bool33 var isTyped: Bool34 }3536 var nodes: [Node] = []37 var edges: [Edge] = []38 var selectedNodeId: String?39 var selectedEdgeId: String?40 var highlighted: Set<String> = []4142 static func radius(degree: Int?) -> CGFloat { 5 + min(9, CGFloat(degree ?? 0) * 1.4) }4344 /// Builds the scene of a server graph. `labelLimit` = how many of the best-connected nodes are labelled.45 static func make(nodes: [GraphNode], edges: [GraphEdge], positions: [String: CGPoint], selectedNodeId: String?, selectedEdgeId: String?, labelLimit: Int) -> GraphScene {46 var scene = GraphScene()47 scene.selectedNodeId = selectedNodeId48 scene.selectedEdgeId = selectedEdgeId49 var neighbours = Set<String>()50 if let selectedNodeId {51 for edge in edges where edge.source == selectedNodeId || edge.target == selectedNodeId {52 neighbours.insert(edge.source)53 neighbours.insert(edge.target)54 }55 }56 scene.highlighted = neighbours57 let labelled = Set(nodes.sorted { ($0.degree ?? 0, $1.id) > ($1.degree ?? 0, $0.id) }.prefix(labelLimit).map(\.id))58 for node in nodes {59 guard let position = positions[node.id] else { continue }60 scene.nodes.append(Node(id: node.id, position: position, radius: radius(degree: node.degree), kind: node.kind,61 isAI: node.origin == KnowledgeOrigin.ai, label: KnowledgeVocabulary.title(node.title),62 showsLabel: labelled.contains(node.id) || node.id == selectedNodeId || neighbours.contains(node.id)))63 }64 for edge in edges {65 guard let from = positions[edge.source], let to = positions[edge.target] else { continue }66 scene.edges.append(Edge(id: edge.id, source: edge.source, target: edge.target, from: from, to: to, isAI: GraphModel.isAI(edge), isSuggestion: GraphModel.isSuggestion(edge), isTyped: edge.kind == GraphEdgeKind.typed))67 }68 return scene69 }70}7172/// The animatable drawing: `progress` 0 → 1 draws the edges.73struct GraphCanvasBody: View, @preconcurrency Animatable {74 var scene: GraphScene75 var viewport: GraphViewport76 var progress: CGFloat77 var showsLabels = true78 /// Compact mini-graph: smaller dots.79 var nodeScale: CGFloat = 18081 var animatableData: CGFloat {82 get { progress }83 set { progress = newValue }84 }8586 var body: some View {87 Canvas { context, size in88 let hasSelection = scene.selectedNodeId != nil89 for edge in scene.edges {90 let a = viewport.toView(edge.from, in: size), b = viewport.toView(edge.to, in: size)91 var path = Path()92 path.move(to: a)93 path.addLine(to: b)94 let drawn = path.trimmedPath(from: 0, to: max(0, min(1, progress)))95 let selected = edge.id == scene.selectedEdgeId96 let dimmed = hasSelection && !selected && !(scene.highlightedEdge(edge))97 let colour: Color = edge.isAI ? NVColor.ai : (edge.isTyped ? NVColor.accent : NVColor.lineStrong)98 let style = StrokeStyle(lineWidth: selected ? 2.6 : (edge.isTyped || edge.isAI ? 1.6 : 1.1), lineCap: .round, dash: edge.isSuggestion ? [5, 4] : [])99 context.stroke(drawn, with: .color(colour.opacity(dimmed ? 0.25 : 0.9)), style: style)100 }101 for node in scene.nodes {102 let p = viewport.toView(node.position, in: size)103 let selected = node.id == scene.selectedNodeId104 let dimmed = hasSelection && !selected && !scene.highlighted.contains(node.id)105 let r = node.radius * nodeScale * min(1.6, max(0.8, viewport.scale.squareRoot()))106 let rect = CGRect(x: p.x - r, y: p.y - r, width: r * 2, height: r * 2)107 let colour = KnowledgeVocabulary.nodeColor(node.kind, isAI: node.isAI)108 if selected {109 context.fill(Path(ellipseIn: rect.insetBy(dx: -5, dy: -5)), with: .color(NVColor.accentSoft))110 context.stroke(Path(ellipseIn: rect.insetBy(dx: -5, dy: -5)), with: .color(NVColor.accent), lineWidth: 1.5)111 }112 context.fill(Path(ellipseIn: rect), with: .color(colour.opacity(dimmed ? 0.35 : 1)))113 context.stroke(Path(ellipseIn: rect), with: .color(NVColor.bgElevated), lineWidth: 1.5)114 if showsLabels, node.showsLabel, !dimmed || selected {115 let text = Text(node.label).font(NVFont.fixed(.micro)).foregroundStyle(selected ? NVColor.fg : NVColor.fgMuted)116 let resolved = context.resolve(text)117 let measured = resolved.measure(in: CGSize(width: 150, height: 32))118 let origin = CGPoint(x: p.x - measured.width / 2, y: p.y + r + 3)119 let back = CGRect(origin: origin, size: measured).insetBy(dx: -3, dy: -1)120 context.fill(Path(roundedRect: back, cornerRadius: 4), with: .color(NVColor.bg.opacity(0.82)))121 context.draw(resolved, in: CGRect(origin: origin, size: measured))122 }123 }124 }125 }126}127128extension GraphScene {129 func highlightedEdge(_ edge: Edge) -> Bool {130 guard let selectedNodeId else { return false }131 return edge.source == selectedNodeId || edge.target == selectedNodeId132 }133}134135/// Interactive graph surface: drag = pan, pinch = zoom, tap = select. The gestures only call the closures.136struct GraphSurface: View {137 @Environment(\.accessibilityReduceMotion) private var reduceMotion138 var scene: GraphScene139 var viewport: GraphViewport140 /// Changes when a new layout arrives: replays the edge-draw motion.141 var generation: Int142 var showsLabels = true143 var nodeScale: CGFloat = 1144 var onTap: (CGPoint, CGSize) -> Void = { _, _ in }145 var onPan: (CGSize) -> Void = { _ in }146 var onZoom: (CGFloat, CGPoint, CGSize) -> Void = { _, _, _ in }147 var accessibilitySummary: String148149 @State private var progress: CGFloat = 0150 @State private var lastDrag: CGSize = .zero151 @State private var lastMagnification: CGFloat = 1152153 var body: some View {154 GeometryReader { proxy in155 GraphCanvasBody(scene: scene, viewport: viewport, progress: progress, showsLabels: showsLabels, nodeScale: nodeScale)156 .contentShape(Rectangle())157 .gesture(158 DragGesture(minimumDistance: 4)159 .onChanged { value in160 onPan(CGSize(width: value.translation.width - lastDrag.width, height: value.translation.height - lastDrag.height))161 lastDrag = value.translation162 }163 .onEnded { _ in lastDrag = .zero }164 )165 .simultaneousGesture(166 MagnifyGesture()167 .onChanged { value in168 onZoom(value.magnification / lastMagnification, value.startLocation, proxy.size)169 lastMagnification = value.magnification170 }171 .onEnded { _ in lastMagnification = 1 }172 )173 .simultaneousGesture(SpatialTapGesture().onEnded { value in onTap(value.location, proxy.size) })174 }175 .onAppear { draw() }176 .onChange(of: generation) { _, _ in draw() }177 .accessibilityElement()178 .accessibilityLabel(accessibilitySummary)179 .accessibilityAddTraits(.isImage)180 }181182 private func draw() {183 if reduceMotion {184 progress = 1 // the edges appear complete; no drawing motion185 } else {186 progress = 0187 withNVAnimation(.slow, reduceMotion: false) { progress = 1 }188 }189 }190}191