import AppKit import Foundation import UniformTypeIdentifiers /// SIP-008 草稿的用户选择与文件写入边界;内容准备由 CatalogWorkflow 拥有。 @MainActor protocol ConfigurationGroupFileExporter { func export(draft: ConfigurationGroupExportDraft) -> ConfigurationGroupFileExportResult } enum ConfigurationGroupFileExportFailure: Equatable, Error { case writeFailed } enum ConfigurationGroupFileExportResult: Equatable { case cancelled case saved(URL) case failed(ConfigurationGroupFileExportFailure) } enum ConfigurationGroupExportOutcome: Equatable { case preparationFailed(ConfigurationGroupExportFailure) case cancelled case saved(URL) case exportFailed(ConfigurationGroupFileExportFailure) } /// 先准备完整文档,再调用 exporter;准备失败时不会打开面板或接触文件效果。 @MainActor struct ConfigurationGroupExportAction { let workflow: CatalogWorkflow let exporter: any ConfigurationGroupFileExporter func perform(for groupID: NodeID) -> ConfigurationGroupExportOutcome { let draft: ConfigurationGroupExportDraft do { draft = try workflow.configurationGroupExportDraft(for: groupID) } catch let failure as ConfigurationGroupExportFailure { return .preparationFailed(failure) } catch { return .preparationFailed(.documentEncodingFailed) } switch exporter.export(draft: draft) { case .cancelled: return .cancelled case .saved(let url): return .saved(url) case .failed(let failure): return .exportFailed(failure) } } } /// 生产文件边界:JSON 保存面板与原子文件写入集中在 AppKit adapter。 @MainActor final class AppKitConfigurationGroupFileExporter: ConfigurationGroupFileExporter { func export(draft: ConfigurationGroupExportDraft) -> ConfigurationGroupFileExportResult { let panel = NSSavePanel() panel.allowedContentTypes = [.json] panel.nameFieldStringValue = draft.suggestedFileName guard panel.runModal() == .OK, let url = panel.url else { return .cancelled } do { try draft.data.write(to: url, options: .atomic) return .saved(url) } catch { return .failed(.writeFailed) } } } /// Tests and previews receive the complete draft without opening a panel or writing a file. @MainActor final class InMemoryConfigurationGroupFileExporter: ConfigurationGroupFileExporter { var result: ConfigurationGroupFileExportResult private(set) var drafts: [ConfigurationGroupExportDraft] = [] init(result: ConfigurationGroupFileExportResult = .cancelled) { self.result = result } func export(draft: ConfigurationGroupExportDraft) -> ConfigurationGroupFileExportResult { drafts.append(draft) return result } }