Repository Public
1// ORIX DJ2// File: App/Sources/Features/AutomationStudio/AutomationStudioView.swift3// Description: The Automation Studio: a native IDE for ORIX Script. Explorer, tabbed code editor, inspector and the4// bottom panels (console, simulator, debugger, problems, log, monitor), plus the presets gallery and the5// Visual Builder as alternative centre modes.6//7// Author: Simon-Pierre Boucher8// Contact: contact@spboucher.ai9import ORIXDJCore10import SwiftUI1112struct AutomationStudioView: View {13 @Environment(AppModel.self) private var model14 @State private var studio = AutomationStudioState()1516 init() {}1718 var body: some View {19 VStack(spacing: 0) {20 StudioToolbar(studio: studio)21 Divider().overlay(ORIX.Palette.hairline)22 HSplitView {23 if studio.showExplorer {24 ScriptExplorerView(studio: studio).frame(minWidth: 200, idealWidth: 236, maxWidth: 320, maxHeight: .infinity)25 }26 VSplitView {27 centre.frame(minWidth: 480, maxWidth: .infinity, minHeight: 180, maxHeight: .infinity).layoutPriority(1)28 StudioBottomPanel(studio: studio).frame(minWidth: 480, maxWidth: .infinity, minHeight: studio.tab == .simulator || studio.tab == .debugger ? 340 : 210, idealHeight: 340, maxHeight: .infinity)29 }30 .layoutPriority(1)31 if studio.showInspector {32 StudioInspectorView(studio: studio).frame(minWidth: 220, idealWidth: 262, maxWidth: 340, maxHeight: .infinity)33 }34 }35 }36 .background(ORIX.Palette.canvas)37 .background { shortcuts }38 .task { studio.applyLaunchOptions(model: model) }39 // The Run menu command (⌘R) arrives as a counter so it always goes through the live-mix confirmation.40 .task(id: model.runRequests) {41 guard model.runRequests != model.handledRunRequests else { return }42 model.handledRunRequests = model.runRequests43 studio.perform(.run, model: model)44 }45 .onChange(of: model.documents.map(\.id)) { _, _ in studio.prune(openDocuments: model.documents) }46 .confirmationDialog("Run on the live mix?", isPresented: Binding(get: { studio.pendingRun != nil }, set: { if !$0 { studio.pendingRun = nil } }), presenting: studio.pendingRun) { run in47 Button("Run on the Live Mix") { studio.start(run, model: model) }48 Button("Simulate Instead") { studio.pendingRun = nil; studio.simulate(source: run.source, title: run.title, docID: model.activeDocument?.source == run.source ? model.activeDocumentID : nil, automation: run.automation) }49 Button("Cancel", role: .cancel) { studio.pendingRun = nil }50 } message: { run in51 let playing = model.decks.filter(\.playing).map { deckLetters[$0.index] }.joined(separator: ", ")52 Text("Deck \(playing) is playing. \"\(run.title)\" will act on the live mix: it can move faders, filters and effects and start or stop decks while the audience hears it.")53 }54 .confirmationDialog("Save the changes?", isPresented: Binding(get: { studio.closeRequest != nil }, set: { if !$0 { studio.closeRequest = nil } }), presenting: studio.closeRequest) { id in55 Button("Save") {56 model.activeDocumentID = id57 if model.activeDocument?.recordID == nil { studio.beginSaveAs(model: model) }58 else if model.saveActiveDocument() { model.close(document: id) }59 }60 Button("Discard Changes", role: .destructive) { model.close(document: id) }61 Button("Cancel", role: .cancel) {}62 } message: { id in63 Text("\"\(model.documents.first { $0.id == id }?.name ?? "")\" has changes that are not saved in the script library.")64 }65 .alert("Save Script As", isPresented: Binding(get: { studio.saveAsRequest }, set: { studio.saveAsRequest = $0 })) {66 @Bindable var studio = studio67 TextField("Name", text: $studio.saveAsName)68 Button("Save") { studio.confirmSaveAs(model: model) }69 Button("Cancel", role: .cancel) {}70 } message: { Text("The script is stored in the library under this name.") }71 .accessibilityElement(children: .contain).accessibilityIdentifier("automation-studio")72 }7374 @ViewBuilder private var centre: some View {75 switch studio.mode {76 case .editor: StudioEditorPane(studio: studio)77 case .presets: PresetsGalleryView(studio: studio)78 case .builder: VisualBuilderView(studio: studio)79 }80 }8182 /// Keyboard shortcuts that work wherever the focus is inside the studio.83 private var shortcuts: some View {84 Group {85 Button("Save") { studio.perform(.save, model: model) }.keyboardShortcut("s", modifiers: [.command])86 Button("Save As") { studio.perform(.saveAs, model: model) }.keyboardShortcut("s", modifiers: [.command, .shift])87 Button("Stop") { studio.perform(.stop, model: model) }.keyboardShortcut(".", modifiers: [.command])88 Button("Validate") { studio.perform(.validate, model: model) }.keyboardShortcut("b", modifiers: [.command])89 Button("Simulate") { studio.perform(.simulate, model: model) }.keyboardShortcut("d", modifiers: [.command])90 Button("Format") { studio.perform(.format, model: model) }.keyboardShortcut("l", modifiers: [.command, .option])91 }92 .opacity(0).frame(width: 0, height: 0).accessibilityHidden(true)93 }94}9596// MARK: - Toolbar9798struct StudioToolbar: View {99 @Environment(AppModel.self) private var model100 let studio: AutomationStudioState101102 private var separator: some View { Rectangle().fill(ORIX.Palette.hairline).frame(width: 1, height: 18).accessibilityHidden(true) }103104 var body: some View {105 // The full toolbar when it fits; icon-only action buttons at narrow widths.106 ViewThatFits(in: .horizontal) {107 content(compact: false)108 content(compact: true)109 }110 .padding(.horizontal, ORIX.Space.sm)111 .frame(height: 38)112 .frame(maxWidth: .infinity)113 .background(ORIX.Palette.surface)114 .accessibilityElement(children: .contain).accessibilityIdentifier("automation-toolbar")115 }116117 private func content(compact: Bool) -> some View {118 @Bindable var studio = studio119 let editing = studio.mode == .editor120 return HStack(spacing: 5) {121 Picker("Mode", selection: $studio.mode) {122 ForEach(StudioMode.allCases) { m in Label(m.title, systemImage: m.symbol).tag(m) }123 }124 .pickerStyle(.segmented).labelsHidden().fixedSize()125 .accessibilityIdentifier("automation-mode")126 separator127 StudioIconButton(title: "New", symbol: "plus") { model.newDocument(); studio.mode = .editor }.accessibilityIdentifier("automation-new")128 StudioIconButton(title: "Open (Script Explorer)", symbol: "sidebar.left", tint: studio.showExplorer ? ORIX.Palette.accent : ORIX.Palette.textPrimary) { studio.showExplorer.toggle() }129 .accessibilityValue(studio.showExplorer ? Text("shown") : Text("hidden"))130 .accessibilityIdentifier("automation-open")131 Group {132 StudioIconButton(title: "Save (⌘S)", symbol: "square.and.arrow.down.on.square") { studio.save(model: model) }.accessibilityIdentifier("automation-save")133 StudioIconButton(title: "Save As… (⇧⌘S)", symbol: "square.and.arrow.down.on.square.fill") { studio.beginSaveAs(model: model) }.accessibilityIdentifier("automation-save-as")134 StudioIconButton(title: "Duplicate", symbol: "plus.square.on.square") { studio.duplicateActive(model: model) }.accessibilityIdentifier("automation-duplicate")135 separator136 StudioIconButton(title: "Validate", symbol: "checkmark.seal", showsTitle: !compact) { studio.validateActive(model: model) }.help("Validate (⌘B)").accessibilityIdentifier("automation-validate")137 StudioIconButton(title: "Format (⌥⌘L)", symbol: "text.alignleft") { studio.formatActive(model: model) }.accessibilityIdentifier("automation-format")138 separator139 StudioIconButton(title: "Run", symbol: "play.fill", tint: ORIX.Palette.success, showsTitle: !compact) { studio.requestRunActive(model: model) }140 .help("Run on the live engine (⌘R). Asks first when a deck is playing.")141 .accessibilityIdentifier("automation-run")142 }143 .disabled(!editing)144 Menu {145 Button("Stop This Script's Runs") { studio.stopActiveScript(model: model) }146 Button("Stop All Automations") { model.host.stopAll(); model.refreshNow() }147 } label: {148 Label("Stop", systemImage: "stop.fill").font(.system(size: 11, weight: .medium))149 } primaryAction: { studio.stopActiveScript(model: model) }150 .menuStyle(.borderedButton).controlSize(.small).fixedSize()151 .help("Stops the runs started from this script (⌘.). When none is running, stops every automation.")152 .accessibilityIdentifier("automation-stop")153 Group {154 StudioIconButton(title: "Debug", symbol: "ant", showsTitle: !compact) { studio.debugActive(model: model) }155 .help("Starts a debug session in the simulator. Live audio is never paused.")156 .accessibilityIdentifier("automation-debug")157 StudioIconButton(title: "Simulate", symbol: "chart.xyaxis.line", showsTitle: !compact) { studio.simulateActive(model: model) }.help("Simulate in the simulated rig (⌘D)").accessibilityIdentifier("automation-simulate")158 separator159 StudioIconButton(title: "Export…", symbol: "square.and.arrow.up") { ScriptFiles.exportActive(model: model) }.accessibilityIdentifier("automation-export")160 }161 .disabled(!editing)162 StudioIconButton(title: "Import…", symbol: "square.and.arrow.down") { ScriptFiles.importScripts(model: model); studio.mode = .editor }.accessibilityIdentifier("automation-import")163 Spacer(minLength: 4)164 if !model.runs.isEmpty {165 Label("\(model.runs.count) running", systemImage: "waveform.path").font(.system(size: 11, weight: .medium)).foregroundStyle(ORIX.Palette.accent).lineLimit(1).fixedSize()166 }167 Button { model.emergencyStop() } label: {168 Label("Emergency Stop", systemImage: "hand.raised.fill").font(.system(size: 11, weight: .semibold)).lineLimit(1).fixedSize()169 .padding(.horizontal, 8).frame(height: 24)170 .foregroundStyle(ORIX.Palette.danger)171 .overlay(RoundedRectangle(cornerRadius: ORIX.Radius.chip).strokeBorder(ORIX.Palette.danger))172 }173 .buttonStyle(.plain)174 .help("Stops every automation and bypasses every effect. Decks keep playing.")175 .accessibilityIdentifier("automation-emergency-stop")176 StudioIconButton(title: "Inspector", symbol: "sidebar.right", tint: studio.showInspector ? ORIX.Palette.accent : ORIX.Palette.textPrimary) { studio.showInspector.toggle() }177 .accessibilityValue(studio.showInspector ? Text("shown") : Text("hidden"))178 .accessibilityIdentifier("automation-toggle-inspector")179 }180 }181}182183// MARK: - Editor pane184185struct StudioEditorPane: View {186 @Environment(AppModel.self) private var model187 let studio: AutomationStudioState188189 var body: some View {190 VStack(spacing: 0) {191 tabs192 Divider().overlay(ORIX.Palette.hairline)193 if let doc = model.activeDocument {194 let controller = studio.editor(for: doc, model: model)195 GeometryReader { geo in196 ZStack(alignment: .topLeading) {197 ScriptEditorView(controller: controller, source: doc.source, diagnostics: studio.diagnostics(for: doc),198 breakpoints: studio.breakpoints[doc.id] ?? [], pausedLine: studio.pausedLine(for: doc.id))199 CompletionPopupView(controller: controller, size: geo.size)200 }201 }202 .onAppear { studio.scheduleValidation(id: doc.id, source: doc.source, delay: .zero) }203 .onChange(of: doc.id) { _, _ in if let d = model.activeDocument { studio.scheduleValidation(id: d.id, source: d.source, delay: .zero) } }204 Divider().overlay(ORIX.Palette.hairline)205 status(doc, controller: controller)206 } else {207 EmptyState(symbol: "doc.text", title: "No script open", message: "Create a script or open one from the explorer.", actionTitle: "New Script", action: { model.newDocument() })208 }209 }210 .background(ORIX.Palette.surface)211 }212213 private var tabs: some View {214 ScrollView(.horizontal, showsIndicators: false) {215 HStack(spacing: 0) {216 ForEach(model.documents) { doc in217 let active = doc.id == model.activeDocumentID218 HStack(spacing: 6) {219 // A filled dot marks unsaved changes (also announced in words).220 Circle().fill(doc.isDirty ? ORIX.Palette.warning : .clear).frame(width: 7, height: 7)221 .overlay(Circle().strokeBorder(doc.isDirty ? ORIX.Palette.warning : ORIX.Palette.hairline))222 .accessibilityHidden(true)223 Text(verbatim: doc.name).font(.system(size: 12, weight: active ? .semibold : .regular)).foregroundStyle(active ? ORIX.Palette.textPrimary : ORIX.Palette.textSecondary).lineLimit(1)224 if doc.isDirty { Text("edited").font(.system(size: 9)).foregroundStyle(ORIX.Palette.textTertiary) }225 Button { if doc.isDirty { studio.closeRequest = doc.id } else { model.close(document: doc.id) } } label: {226 Image(systemName: "xmark").font(.system(size: 8, weight: .bold)).frame(width: 16, height: 16).contentShape(Rectangle())227 }228 .buttonStyle(.plain).foregroundStyle(ORIX.Palette.textTertiary)229 .help("Close").accessibilityLabel(Text("Close \(doc.name)"))230 }231 .padding(.leading, 10).padding(.trailing, 4).frame(height: 30)232 .background(active ? ORIX.Palette.surface : ORIX.Palette.surfaceRaised.opacity(0.5))233 .overlay(alignment: .top) { Rectangle().fill(active ? ORIX.Palette.accent : .clear).frame(height: 2) }234 .overlay(alignment: .trailing) { Rectangle().fill(ORIX.Palette.hairline).frame(width: 1) }235 .contentShape(Rectangle())236 .onTapGesture { model.activeDocumentID = doc.id }237 .accessibilityElement(children: .combine)238 .accessibilityLabel(Text(verbatim: doc.name + (doc.isDirty ? ", edited" : "")))239 .accessibilityAddTraits(active ? [.isSelected, .isButton] : [.isButton])240 .accessibilityIdentifier("automation-tab-\(doc.name)")241 }242 }243 }244 .frame(height: 30)245 .background(ORIX.Palette.canvas)246 .accessibilityIdentifier("automation-tabs")247 }248249 private func status(_ doc: ScriptDocument, controller: CodeEditorController) -> some View {250 let validation = studio.validations[doc.id]251 let errors = validation?.result.errors.count ?? 0, warnings = validation?.result.warnings.count ?? 0252 return HStack(spacing: ORIX.Space.sm) {253 Text(verbatim: "Ln \(studio.caretLine), Col \(studio.caretColumn)").monospacedDigit()254 if validation == nil || validation?.source != doc.source {255 Label("Validating", systemImage: "hourglass")256 } else if errors > 0 {257 Button { studio.tab = .problems } label: { Label("\(errors) error\(errors == 1 ? "" : "s")", systemImage: "xmark.octagon.fill") }.buttonStyle(.plain).foregroundStyle(ORIX.Palette.danger)258 } else if warnings > 0 {259 Button { studio.tab = .problems } label: { Label("\(warnings) warning\(warnings == 1 ? "" : "s")", systemImage: "exclamationmark.triangle.fill") }.buttonStyle(.plain).foregroundStyle(ORIX.Palette.warning)260 } else {261 Label("Valid", systemImage: "checkmark.circle.fill").foregroundStyle(ORIX.Palette.success)262 }263 let points = studio.breakpoints[doc.id]?.count ?? 0264 if points > 0 { Text("\(points) breakpoint\(points == 1 ? "" : "s")") }265 Spacer()266 Text(doc.recordID == nil ? "Not in the library" : (doc.isDirty ? "Edited since last save" : "Saved"))267 Text(verbatim: "ORIX Script \(ORIXScriptLanguage.version)")268 }269 .font(.system(size: 10.5)).foregroundStyle(ORIX.Palette.textSecondary).labelStyle(.titleAndIcon)270 .padding(.horizontal, ORIX.Space.sm).frame(height: 22)271 .background(ORIX.Palette.surface)272 .accessibilityElement(children: .contain).accessibilityIdentifier("automation-editor-status")273 }274}275276// MARK: - Bottom panel277278struct StudioBottomPanel: View {279 @Environment(AppModel.self) private var model280 let studio: AutomationStudioState281282 private func badge(_ tab: StudioTab) -> String? {283 switch tab {284 case .problems:285 let n = studio.diagnostics(for: model.activeDocument).count286 return n > 0 ? "\(n)" : nil287 case .monitor: return model.runs.isEmpty ? nil : "\(model.runs.count)"288 case .debugger: return studio.debug?.snapshot.pausedLine != nil ? "paused" : nil289 default: return nil290 }291 }292293 var body: some View {294 VStack(spacing: 0) {295 HStack(spacing: 2) {296 ForEach(StudioTab.allCases) { tab in297 let selected = studio.tab == tab298 Button { studio.tab = tab } label: {299 HStack(spacing: 5) {300 Image(systemName: tab.symbol).font(.system(size: 10, weight: .semibold))301 Text(tab.title).font(.system(size: 11.5, weight: selected ? .semibold : .regular))302 if let b = badge(tab) {303 Text(verbatim: b).font(.system(size: 9, weight: .bold).monospacedDigit()).padding(.horizontal, 4).frame(minWidth: 14, minHeight: 14)304 .foregroundStyle(ORIX.Palette.textPrimary).background(ORIX.Palette.hairline, in: Capsule())305 }306 }307 .padding(.horizontal, 9).frame(height: 26)308 .foregroundStyle(selected ? ORIX.Palette.textPrimary : ORIX.Palette.textSecondary)309 .overlay(alignment: .bottom) { Rectangle().fill(selected ? ORIX.Palette.accent : .clear).frame(height: 2) }310 .contentShape(Rectangle())311 }312 .buttonStyle(.plain)313 .accessibilityAddTraits(selected ? [.isSelected] : [])314 .accessibilityIdentifier("automation-tab-\(tab.rawValue)")315 }316 Spacer()317 }318 .padding(.horizontal, ORIX.Space.xs)319 .background(ORIX.Palette.surfaceRaised.opacity(0.6))320 Divider().overlay(ORIX.Palette.hairline)321 Group {322 switch studio.tab {323 case .console: AutomationConsolePanel()324 case .simulator: AutomationSimulatorPanel(studio: studio)325 case .debugger: AutomationDebuggerPanel(studio: studio)326 case .problems: AutomationProblemsPanel(studio: studio)327 case .log: AutomationLogPanel(studio: studio)328 case .monitor: AutomationMonitorPanel()329 }330 }331 .frame(maxWidth: .infinity, maxHeight: .infinity)332 }333 .background(ORIX.Palette.surface)334 .accessibilityElement(children: .contain).accessibilityIdentifier("automation-bottom-panel")335 }336}337