Repository Public
1import AppKit2import SwiftUI3import SheetCore4import SheetCharts5import SheetUI6import AnalysisKit7import FunctionsNumeric8import FunctionsLookup910/// Development harness shared by `analysis-preview` and the per-target previews.11///12/// <preview> [--pane <id>] [--tool <id>] [--shot out.png] [--dark] [--size WxH]13/// [--action <result action id>] [--write-report] [--grid] [--sheet <name>] [--studio] [--list]14///15/// `--studio` shows an inspector pane's tools in their roomy studio variant (pane id + "-studio").16///17/// `--tool` selects a tool, fills its form with the tool's demo values and runs it on the demo workbook.18/// `--action` then performs one of the result's actions, `--write-report` writes the report to a new sheet,19/// `--grid` goes back to the grid (to look at what was written), `--sheet` activates a sheet first.20/// With `--shot` the window content is rendered to a PNG by the app itself and the process exits.21@MainActor public enum AnalysisPreview {22 public struct Pane {23 public var id: String, title: String, systemImage: String24 public var placement: WorkspacePane.Placement25 public var tools: [ToolDescriptor]26 public init(id: String, title: String, systemImage: String, placement: WorkspacePane.Placement, tools: [ToolDescriptor]) {27 self.id = id; self.title = title; self.systemImage = systemImage; self.placement = placement; self.tools = tools28 }29 }3031 /// - Parameter register: registers the real feature; when nil the harness registers plain panes for `panes`.32 public static func main(panes: [Pane], register: (@MainActor () -> Void)? = nil) -> Never {33 NumericFunctions.register()34 FinancialFunctions.register()35 LookupFunctions.register()36 if CommandLine.arguments.contains("--list") {37 for p in panes { for t in p.tools { print("\(p.id)\t\(t.id)\t\(t.group)\t\(t.title)") } }38 exit(0)39 }40 let app = NSApplication.shared41 let delegate = PreviewDelegate(panes: panes, register: register)42 app.delegate = delegate43 app.setActivationPolicy(CommandLine.arguments.contains("--shot") ? .accessory : .regular)44 withExtendedLifetime(delegate) { app.run() }45 exit(0)46 }4748 /// Registers generic panes (used when the feature's own `register()` is not linked).49 static func registerPlain(_ panes: [Pane]) {50 // merge panes that share an id (two targets contributing to the same studio)51 var merged = [Pane]()52 for p in panes { if let i = merged.firstIndex(where: { $0.id == p.id }) { merged[i].tools += p.tools } else { merged.append(p) } }53 for p in merged {54 Workspace.shared.register(WorkspacePane(id: p.id, title: LocalizedStringKey(p.title), systemImage: p.systemImage, placement: p.placement) { session in55 let model = StudioStore.model(studio: p.id, session: session, tools: p.tools)56 return p.placement == .studio ? AnyView(ToolStudioView(model: model, session: session))57 : AnyView(ToolInspectorView(model: model, session: session, title: p.title, studioPane: p.id + "-studio"))58 })59 if p.placement != .studio {60 Workspace.shared.register(WorkspacePane(id: p.id + "-studio", title: LocalizedStringKey(p.title), systemImage: p.systemImage, placement: .studio) { session in61 AnyView(ToolStudioView(model: StudioStore.model(studio: p.id, session: session, tools: p.tools), session: session))62 })63 }64 }65 }6667 /// Draws chart objects in the grid so screenshots show inserted charts (the app's chart feature does this in production).68 static func registerChartRenderer() {69 Workspace.shared.register(objectKind: ChartSpec.objectKind, ObjectRenderer(70 draw: { object, session, context, rect, dark in71 guard var spec = ChartSpec(sheetObject: object) else { return }72 spec.theme = ResultChartTheme.theme(dark: dark, base: spec.theme)73 context.saveGState()74 context.translateBy(x: rect.minX, y: rect.minY)75 let canvas = CGChartCanvas(context: context, height: rect.height, flipped: true)76 ChartRenderer.draw(spec, source: WorkbookDataSource(workbook: session.workbook), in: canvas, size: rect.size)77 context.restoreGState()78 },79 open: { _, _ in }))80 }81}8283@MainActor final class PreviewDelegate: NSObject, NSApplicationDelegate {84 let panes: [AnalysisPreview.Pane]85 let register: (@MainActor () -> Void)?86 var window: NSWindow!87 var session: WorkbookSession!8889 init(panes: [AnalysisPreview.Pane], register: (@MainActor () -> Void)?) { self.panes = panes; self.register = register }9091 func applicationDidFinishLaunching(_ notification: Notification) {92 let args = CommandLine.arguments93 func value(_ flag: String) -> String? { args.firstIndex(of: flag).flatMap { $0 + 1 < args.count ? args[$0 + 1] : nil } }94 var size = NSSize(width: 1440, height: 900)95 if let s = value("--size")?.split(separator: "x").compactMap({ Double($0) }), s.count == 2 { size = NSSize(width: s[0], height: s[1]) }96 if args.contains("--dark") { NSApp.appearance = NSAppearance(named: .darkAqua) }9798 if let register { register() } else { AnalysisPreview.registerPlain(panes) }99 AnalysisPreview.registerChartRenderer()100 session = DemoWorkbook.make()101102 // merged view of the tools per pane id103 var tools = [String: [ToolDescriptor]]()104 for p in panes { tools[p.id, default: []] += p.tools }105 let toolID = value("--tool")106 var paneID = value("--pane") ?? panes.first?.id107 if let toolID, let owner = panes.first(where: { p in p.tools.contains { $0.id == toolID } }) { paneID = owner.id }108 if let toolID, !panes.contains(where: { p in p.tools.contains { $0.id == toolID } }) {109 FileHandle.standardError.write(Data("unknown tool id: \(toolID) (use --list)\n".utf8))110 exit(2)111 }112 if let s = value("--sheet"), let i = session.workbook.sheetIndex(named: s) { session.activateSheet(i) }113 let pane = panes.first { $0.id == paneID }114 var model: ToolSessionModel?115 if let pane {116 let m = StudioStore.model(studio: pane.id, session: session, tools: tools[pane.id] ?? [])117 model = m118 if pane.placement == .studio { session.studioPane = pane.id; session.inspectorPane = nil }119 else if args.contains("--studio") { session.studioPane = pane.id + "-studio"; session.inspectorPane = nil }120 else { session.inspectorPane = pane.id }121 if let toolID { m.loadDemo(toolID, session: session) }122 }123124 let shot = value("--shot")125 let style: NSWindow.StyleMask = shot != nil ? [.borderless] : [.titled, .closable, .resizable, .miniaturizable]126 window = NSWindow(contentRect: NSRect(origin: .zero, size: size), styleMask: style, backing: .buffered, defer: false)127 window.title = "ORIX Sheet — analysis preview"128 window.contentView = NSHostingView(rootView: WorkbookView(session: session))129 window.setContentSize(size)130 if shot == nil { window.center() }131 window.makeKeyAndOrderFront(nil)132 NSApp.activate(ignoringOtherApps: false)133134 Task { @MainActor in135 if let toolID, let model, model.tool(toolID)?.customPanel == nil {136 let state = await model.run(toolID, session: self.session)137 switch state {138 case .failed(let message): print("run failed: \(message)")139 case .done(let result):140 print("run ok: \(result.title) — \(result.blocks.count) blocks, actions: \(result.actions.map(\.id).joined(separator: ","))")141 if let actionID = value("--action") {142 if let action = result.actions.first(where: { $0.id == actionID }) { model.perform(action, session: self.session); print("action: \(model.status ?? "done")") }143 else { print("unknown action id: \(actionID)") }144 }145 if args.contains("--write-report") { model.writeReport(toolID, session: self.session); print(model.status ?? "") }146 default: print("run state: \(state)")147 }148 }149 if args.contains("--grid") { self.session.studioPane = nil }150 guard let shot else { return }151 try? await Task.sleep(nanoseconds: 1_300_000_000)152 guard let view = self.window.contentView, let rep = view.bitmapImageRepForCachingDisplay(in: view.bounds) else { exit(2) }153 view.cacheDisplay(in: view.bounds, to: rep)154 try? FileManager.default.createDirectory(at: URL(fileURLWithPath: shot).deletingLastPathComponent(), withIntermediateDirectories: true)155 try? rep.representation(using: .png, properties: [:])?.write(to: URL(fileURLWithPath: shot))156 exit(0)157 }158 }159160 func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool { true }161}162