Merge pull request #261 from datlechin/feat/plugin-settings-system

feat: add plugin settings system with options persistence

Author: datlechin

CHANGELOG.md

@@ -17,6 +17,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Namespaced `disabledPlugins` UserDefaults key to `com.TablePro.disabledPlugins` with automatic migration
+- Removed unused plugin capability types (sqlDialect, aiProvider, cellRenderer, sidebarPanel)
 - SQLite driver extracted from built-in bundle to downloadable plugin, reducing app size
 - Unified error formatting across all database drivers via default `PluginDriverError.errorDescription`, removing 10 per-driver implementations
 - Standardized async bridging: 5 queue-based drivers (MySQL, PostgreSQL, MongoDB, Redis, MSSQL) now use shared `pluginDispatchAsync` helper
@@ -26,6 +28,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Export plugin options (CSV, XLSX, JSON, SQL, MQL) now persist across app restarts
+- Plugins can declare settings views rendered in Settings > Plugins
 - True prepared statements for MSSQL (`sp_executesql`) and ClickHouse (HTTP query parameters), eliminating string interpolation for parameterized queries
 - Batch query operations for MSSQL, Oracle, and ClickHouse, eliminating N+1 query patterns for column, foreign key, and database metadata fetching; SQLite adds a batched `fetchAllForeignKeys` override within PRAGMA limitations
 - `PluginDriverError` protocol in TableProPluginKit for structured error reporting from driver plugins, with richer connection error messages showing error codes and SQL states

Plugins/CSVExportPlugin/CSVExportModels.swift

@@ -5,7 +5,7 @@
 
 import Foundation
 
-public enum CSVDelimiter: String, CaseIterable, Identifiable {
+public enum CSVDelimiter: String, CaseIterable, Identifiable, Codable {
     case comma = ","
     case semicolon = ";"
     case tab = "\\t"
@@ -27,7 +27,7 @@ public enum CSVDelimiter: String, CaseIterable, Identifiable {
     }
 }
 
-public enum CSVQuoteHandling: String, CaseIterable, Identifiable {
+public enum CSVQuoteHandling: String, CaseIterable, Identifiable, Codable {
     case always = "Always"
     case asNeeded = "Quote if needed"
     case never = "Never"
@@ -43,7 +43,7 @@ public enum CSVQuoteHandling: String, CaseIterable, Identifiable {
     }
 }
 
-public enum CSVLineBreak: String, CaseIterable, Identifiable {
+public enum CSVLineBreak: String, CaseIterable, Identifiable, Codable {
     case lf = "\\n"
     case crlf = "\\r\\n"
     case cr = "\\r"
@@ -59,7 +59,7 @@ public enum CSVLineBreak: String, CaseIterable, Identifiable {
     }
 }
 
-public enum CSVDecimalFormat: String, CaseIterable, Identifiable {
+public enum CSVDecimalFormat: String, CaseIterable, Identifiable, Codable {
     case period = "."
     case comma = ","
 
@@ -68,7 +68,7 @@ public enum CSVDecimalFormat: String, CaseIterable, Identifiable {
     public var separator: String { rawValue }
 }
 
-public struct CSVExportOptions: Equatable {
+public struct CSVExportOptions: Equatable, Codable {
     public var convertNullToEmpty: Bool = true
     public var convertLineBreakToSpace: Bool = false
     public var includeFieldNames: Bool = true

Plugins/CSVExportPlugin/CSVExportPlugin.swift

@@ -20,9 +20,17 @@ final class CSVExportPlugin: ExportFormatPlugin {
     // swiftlint:disable:next force_try
     static let decimalFormatRegex = try! NSRegularExpression(pattern: #"^[+-]?\d+\.\d+$"#)
 
-    var options = CSVExportOptions()
+    private let storage = PluginSettingsStorage(pluginId: "csv")
 
-    required init() {}
+    var options = CSVExportOptions() {
+        didSet { storage.save(options) }
+    }
+
+    required init() {
+        if let saved = storage.load(CSVExportOptions.self) {
+            options = saved
+        }
+    }
 
     func optionsView() -> AnyView? {
         AnyView(CSVExportOptionsView(plugin: self))

Plugins/JSONExportPlugin/JSONExportModels.swift

@@ -5,7 +5,7 @@
 
 import Foundation
 
-public struct JSONExportOptions: Equatable {
+public struct JSONExportOptions: Equatable, Codable {
     public var prettyPrint: Bool = true
     public var includeNullValues: Bool = true
     public var preserveAllAsStrings: Bool = false

Plugins/JSONExportPlugin/JSONExportPlugin.swift

@@ -17,9 +17,17 @@ final class JSONExportPlugin: ExportFormatPlugin {
     static let defaultFileExtension = "json"
     static let iconName = "curlybraces"
 
-    var options = JSONExportOptions()
+    private let storage = PluginSettingsStorage(pluginId: "json")
 
-    required init() {}
+    var options = JSONExportOptions() {
+        didSet { storage.save(options) }
+    }
+
+    required init() {
+        if let saved = storage.load(JSONExportOptions.self) {
+            options = saved
+        }
+    }
 
     func optionsView() -> AnyView? {
         AnyView(JSONExportOptionsView(plugin: self))

Plugins/MQLExportPlugin/MQLExportModels.swift

@@ -5,7 +5,7 @@
 
 import Foundation
 
-public struct MQLExportOptions: Equatable {
+public struct MQLExportOptions: Equatable, Codable {
     public var batchSize: Int = 500
 
     public init() {}

Plugins/MQLExportPlugin/MQLExportPlugin.swift

@@ -24,9 +24,17 @@ final class MQLExportPlugin: ExportFormatPlugin {
         PluginExportOptionColumn(id: "data", label: "Data", width: 44)
     ]
 
-    var options = MQLExportOptions()
+    private let storage = PluginSettingsStorage(pluginId: "mql")
 
-    required init() {}
+    var options = MQLExportOptions() {
+        didSet { storage.save(options) }
+    }
+
+    required init() {
+        if let saved = storage.load(MQLExportOptions.self) {
+            options = saved
+        }
+    }
 
     func defaultTableOptionValues() -> [Bool] {
         [true, true, true]

Plugins/SQLExportPlugin/SQLExportModels.swift

@@ -5,7 +5,7 @@
 
 import Foundation
 
-public struct SQLExportOptions: Equatable {
+public struct SQLExportOptions: Equatable, Codable {
     public var compressWithGzip: Bool = false
     public var batchSize: Int = 500
 

Plugins/SQLExportPlugin/SQLExportPlugin.swift

@@ -25,12 +25,21 @@ final class SQLExportPlugin: ExportFormatPlugin {
         PluginExportOptionColumn(id: "data", label: "Data", width: 44)
     ]
 
-    var options = SQLExportOptions()
+    private let storage = PluginSettingsStorage(pluginId: "sql")
+
+    var options = SQLExportOptions() {
+        didSet { storage.save(options) }
+    }
+
     var ddlFailures: [String] = []
 
     private static let logger = Logger(subsystem: "com.TablePro", category: "SQLExportPlugin")
 
-    required init() {}
+    required init() {
+        if let saved = storage.load(SQLExportOptions.self) {
+            options = saved
+        }
+    }
 
     func defaultTableOptionValues() -> [Bool] {
         [true, true, true]

Plugins/TableProPluginKit/PluginCapability.swift

@@ -4,8 +4,4 @@ public enum PluginCapability: Int, Codable, Sendable {
     case databaseDriver
     case exportFormat
     case importFormat
-    case sqlDialect
-    case aiProvider
-    case cellRenderer
-    case sidebarPanel
 }