Repository Public
1// Author: Simon-Pierre Boucher — contact@spboucher.ai2// File: Components/GridTable.swift3// Description: AppKit table for provider datasets: columns discovered at run time, view-based row reuse (only visible rows exist), sorting, column show/hide/reorder/resize, copy.4import AppKit5import SwiftUI6import VQuantCore78/// NSTableView is used here rather than SwiftUI's Table because the columns are only known once the data arrives9/// and because it virtualises rows natively: a table of several thousand rows keeps a few dozen cell views alive.10struct GridTable: NSViewRepresentable {11 let table: DataTable12 var hidden: Set<String>13 @Binding var sort: (column: String, ascending: Bool)?14 var onDoubleClick: (([String: JSONValue]) -> Void)?1516 func makeCoordinator() -> Coordinator { Coordinator(self) }1718 func makeNSView(context: Context) -> NSScrollView {19 let tv = NSTableView()20 tv.style = .inset21 tv.usesAlternatingRowBackgroundColors = true22 tv.allowsColumnReordering = true; tv.allowsColumnResizing = true; tv.allowsMultipleSelection = true23 tv.columnAutoresizingStyle = .noColumnAutoresizing24 tv.rowHeight = 2225 tv.dataSource = context.coordinator; tv.delegate = context.coordinator26 tv.target = context.coordinator; tv.doubleAction = #selector(Coordinator.doubleClick(_:))27 tv.setAccessibilityLabel("Dataset rows")28 let menu = NSMenu(); menu.addItem(withTitle: "Copy Rows", action: #selector(Coordinator.copy(_:)), keyEquivalent: "c").target = context.coordinator29 tv.menu = menu30 let scroll = NSScrollView()31 scroll.documentView = tv; scroll.hasVerticalScroller = true; scroll.hasHorizontalScroller = true; scroll.autohidesScrollers = true32 context.coordinator.tableView = tv33 return scroll34 }3536 func updateNSView(_ scroll: NSScrollView, context: Context) {37 let c = context.coordinator38 c.parent = self39 guard let tv = c.tableView else { return }40 let wanted = table.columns.filter { !hidden.contains($0) }41 if wanted != c.shownColumns {42 for col in tv.tableColumns { tv.removeTableColumn(col) }43 for name in wanted {44 let col = NSTableColumn(identifier: NSUserInterfaceItemIdentifier(name))45 col.title = Self.header(name)46 col.headerToolTip = name47 col.sortDescriptorPrototype = NSSortDescriptor(key: name, ascending: true)48 let numeric = table.isNumeric(name)49 col.headerCell.alignment = numeric ? .right : .left50 col.width = Self.width(name, numeric: numeric, table: table); col.minWidth = 5051 tv.addTableColumn(col)52 }53 c.shownColumns = wanted54 c.numeric = Dictionary(uniqueKeysWithValues: wanted.map { ($0, table.isNumeric($0)) })55 }56 if c.rows != table.rows { c.rows = table.rows; tv.reloadData() }57 }5859 static func header(_ key: String) -> String {60 // camelCase → words: "netCashProvidedByOperatingActivities" → "Net Cash Provided By Operating Activities"61 var out = ""62 for (i, ch) in key.enumerated() { if ch.isUppercase, i > 0, !(out.last?.isUppercase ?? false) { out.append(" ") }; out.append(i == 0 ? Character(ch.uppercased()) : ch) }63 return out64 }65 static func width(_ name: String, numeric: Bool, table: DataTable) -> CGFloat {66 let sample = table.rows.prefix(30).map { Fmt.cell($0[name]).count }.max() ?? 867 return min(max(CGFloat(max(sample, header(name).count)) * 7.2 + 18, 70), 340)68 }6970 final class Coordinator: NSObject, NSTableViewDataSource, NSTableViewDelegate {71 var parent: GridTable72 weak var tableView: NSTableView?73 var rows: [[String: JSONValue]] = []74 var shownColumns: [String] = []75 var numeric: [String: Bool] = [:]76 init(_ p: GridTable) { parent = p }7778 func numberOfRows(in tableView: NSTableView) -> Int { rows.count }7980 func tableView(_ tableView: NSTableView, viewFor tableColumn: NSTableColumn?, row: Int) -> NSView? {81 guard let col = tableColumn, rows.indices.contains(row) else { return nil }82 let id = NSUserInterfaceItemIdentifier("cell")83 let field: NSTextField84 if let reused = tableView.makeView(withIdentifier: id, owner: nil) as? NSTextField { field = reused }85 else {86 field = NSTextField(labelWithString: ""); field.identifier = id87 field.lineBreakMode = .byTruncatingTail; field.cell?.truncatesLastVisibleLine = true88 field.font = .monospacedDigitSystemFont(ofSize: NSFont.systemFontSize, weight: .regular)89 }90 let v = rows[row][col.identifier.rawValue]91 let text = Fmt.cell(v)92 field.stringValue = text93 field.alignment = numeric[col.identifier.rawValue] == true ? .right : .left94 field.textColor = (v == nil || v == .null) ? .tertiaryLabelColor : .labelColor95 field.toolTip = text.count > 24 ? text : nil96 return field97 }9899 func tableView(_ tableView: NSTableView, sortDescriptorsDidChange oldDescriptors: [NSSortDescriptor]) {100 guard let d = tableView.sortDescriptors.first, let key = d.key else { parent.sort = nil; return }101 parent.sort = (key, d.ascending)102 }103104 @objc func doubleClick(_ sender: NSTableView) { if rows.indices.contains(sender.clickedRow) { parent.onDoubleClick?(rows[sender.clickedRow]) } }105106 /// Copies the selected rows as tab-separated text with a header line (pastes into a spreadsheet).107 @objc func copy(_ sender: Any?) {108 guard let tv = tableView else { return }109 let idx = tv.selectedRowIndexes.isEmpty ? IndexSet(integer: tv.clickedRow).filteredIndexSet { $0 >= 0 } : tv.selectedRowIndexes110 guard !idx.isEmpty else { return }111 let cols = tv.tableColumns.map(\.identifier.rawValue)112 var out = cols.joined(separator: "\t") + "\n"113 for r in idx where rows.indices.contains(r) { out += cols.map { DataTable.text(rows[r][$0]).replacingOccurrences(of: "\t", with: " ") }.joined(separator: "\t") + "\n" }114 NSPasteboard.general.clearContents(); NSPasteboard.general.setString(out, forType: .string)115 }116 }117}118