SPB Git

Repository Public

GraphCanvasView.swift 8.8 KB 191 lines swift

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
Files main
Menu

Theme