SPB Git

Repository Public

AutomationStudioView.swift 20.0 KB 337 lines swift

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

Theme