fix: overhaul Import URL dialog (#865)

* fix: overhaul Import URL with dynamic placeholder, preview, and missing field mappings (#853)

* fix: address review — multiline clipboard, label width, add parser tests

* docs: consolidate Import URL changelog entries

Author: datlechin

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Import URL: dynamic placeholder, parsed preview, clipboard auto-paste, libSQL/D1 support, URL schemes for Oracle/ClickHouse/etcd/D1/libSQL
 - In-app feedback form for bug reports and feature requests via Help > Report an Issue
 - Per-connection "Local only" option to exclude individual connections from iCloud sync
 - Filter operator picker shows SQL symbols alongside names for quick visual recognition

TablePro/Core/Utilities/Connection/ConnectionURLParser.swift

@@ -4,6 +4,7 @@
 //
 
 import Foundation
+import TableProPluginKit
 
 struct ParsedConnectionURL {
     let type: DatabaseType
@@ -129,10 +130,12 @@ struct ConnectionURLParser {
 
         let isSrv = scheme == "mongodb+srv"
 
-        if dbType == .sqlite {
+        let isFileBased = dbType == .sqlite || dbType == .duckdb
+            || PluginMetadataRegistry.shared.snapshot(forTypeId: dbType.pluginTypeId)?.connectionMode == .fileBased
+        if isFileBased {
             let path = String(trimmed[schemeEnd.upperBound...])
             return .success(ParsedConnectionURL(
-                type: .sqlite,
+                type: dbType,
                 host: "",
                 port: nil,
                 database: path,
@@ -205,6 +208,10 @@ struct ConnectionURLParser {
             }
         }
 
+        if scheme == "etcds" {
+            sslMode = sslMode ?? .required
+        }
+
         // Oracle-specific: path component is the service name, not the database name
         var oracleServiceName: String?
         if dbType == .oracle && !database.isEmpty {

TablePro/Info.plist

@@ -243,6 +243,13 @@
 				<string>cql</string>
 				<string>scylladb</string>
 				<string>scylla</string>
+				<string>oracle</string>
+				<string>clickhouse</string>
+				<string>ch</string>
+				<string>etcd</string>
+				<string>etcds</string>
+				<string>d1</string>
+				<string>libsql</string>
 			</array>
 			<key>CFBundleTypeRole</key>
 			<string>Viewer</string>

TablePro/Views/Connection/ConnectionFormView+Footer.swift

@@ -86,34 +86,70 @@ extension ConnectionFormView {
 
     // MARK: - Import from URL Sheet
 
+    private var urlPlaceholder: String {
+        let snapshot = PluginMetadataRegistry.shared.snapshot(forTypeId: type.pluginTypeId)
+        let scheme = snapshot?.primaryUrlScheme ?? type.rawValue.lowercased()
+        let mode = snapshot?.connectionMode ?? .network
+
+        switch mode {
+        case .fileBased:
+            return "\(scheme):///path/to/database"
+        case .apiOnly:
+            if type.pluginTypeId == "libSQL" {
+                return "libsql://your-database.turso.io"
+            }
+            if type.pluginTypeId == "Cloudflare D1" {
+                return "d1://account-id/database-name"
+            }
+            return "\(scheme)://host/database"
+        case .network:
+            let port = snapshot?.defaultPort ?? 0
+            let portStr = port > 0 ? ":\(port)" : ""
+            return "\(scheme)://user:password@host\(portStr)/database"
+        }
+    }
+
+    private var parsedPreview: ParsedConnectionURL? {
+        let trimmed = connectionURL.trimmingCharacters(in: .whitespacesAndNewlines)
+        guard !trimmed.isEmpty else { return nil }
+        if case .success(let parsed) = ConnectionURLParser.parse(trimmed) {
+            return parsed
+        }
+        return nil
+    }
+
     var connectionURLImportSheet: some View {
         VStack(spacing: 16) {
-            Text(String(localized: "Paste a connection URL to auto-fill the form fields."))
+            Text("Paste a connection URL to auto-fill the form fields.")
                 .font(.subheadline)
                 .foregroundStyle(.secondary)
 
             TextField(
                 String(localized: "Connection URL"),
                 text: $connectionURL,
-                prompt: Text("postgresql://user:password@host:5432/database")
+                prompt: Text(urlPlaceholder)
             )
             .textFieldStyle(.roundedBorder)
 
             if let urlParseError {
                 Text(urlParseError)
                     .font(.caption)
                     .foregroundStyle(Color(nsColor: .systemRed))
+            } else if let preview = parsedPreview {
+                urlPreviewView(preview)
             }
 
             HStack {
-                Button(String(localized: "Cancel")) {
+                Button("Cancel") {
+                    connectionURL = ""
+                    urlParseError = nil
                     showURLImport = false
                 }
                 .keyboardShortcut(.cancelAction)
 
                 Spacer()
 
-                Button(String(localized: "Import")) {
+                Button("Import") {
                     parseConnectionURL()
                     if urlParseError == nil && !connectionURL.isEmpty {
                         connectionURL = ""
@@ -128,5 +164,76 @@ extension ConnectionFormView {
         .navigationTitle(String(localized: "Import from URL"))
         .padding(20)
         .frame(width: 420)
+        .onAppear {
+            if connectionURL.isEmpty,
+               let clipString = NSPasteboard.general.string(forType: .string),
+               let firstLine = clipString.components(separatedBy: .newlines).first,
+               firstLine.contains("://")
+            {
+                connectionURL = firstLine.trimmingCharacters(in: .whitespacesAndNewlines)
+            }
+        }
+    }
+
+    private func urlPreviewView(_ parsed: ParsedConnectionURL) -> some View {
+        let snapshot = PluginMetadataRegistry.shared.snapshot(forTypeId: parsed.type.pluginTypeId)
+        let mode = snapshot?.connectionMode ?? .network
+
+        return VStack(alignment: .leading, spacing: 4) {
+            HStack(spacing: 6) {
+                Image(parsed.type.iconName)
+                    .resizable()
+                    .frame(width: 16, height: 16)
+                Text(snapshot?.displayName ?? parsed.type.rawValue)
+                    .font(.caption)
+                    .fontWeight(.medium)
+            }
+
+            switch mode {
+            case .fileBased:
+                if !parsed.database.isEmpty {
+                    previewRow(String(localized: "Path"), parsed.database)
+                }
+            case .apiOnly:
+                if !parsed.host.isEmpty {
+                    previewRow(String(localized: "Host"), parsed.host)
+                }
+            case .network:
+                if !parsed.host.isEmpty {
+                    let portStr = parsed.port.map { ":\($0)" } ?? ""
+                    previewRow(String(localized: "Host"), parsed.host + portStr)
+                }
+                if !parsed.username.isEmpty {
+                    previewRow(String(localized: "User"), parsed.username)
+                }
+                if !parsed.database.isEmpty {
+                    previewRow(String(localized: "Database"), parsed.database)
+                }
+                if let svc = parsed.oracleServiceName, !svc.isEmpty {
+                    previewRow(String(localized: "Service"), svc)
+                }
+                if let sshHost = parsed.sshHost {
+                    previewRow("SSH", sshHost)
+                }
+            }
+        }
+        .padding(8)
+        .frame(maxWidth: .infinity, alignment: .leading)
+        .background(Color(nsColor: .controlBackgroundColor))
+        .clipShape(RoundedRectangle(cornerRadius: 6))
+    }
+
+    private func previewRow(_ label: String, _ value: String) -> some View {
+        HStack(spacing: 4) {
+            Text(label)
+                .font(.caption2)
+                .foregroundStyle(.tertiary)
+                .frame(width: 58, alignment: .trailing)
+            Text(value)
+                .font(.caption)
+                .foregroundStyle(.secondary)
+                .lineLimit(1)
+                .truncationMode(.middle)
+        }
     }
 }

TablePro/Views/Connection/ConnectionFormView+Helpers.swift

@@ -570,8 +570,27 @@ extension ConnectionFormView {
                     additionalFieldValues["mongoParam_\(key)"] = value
                 }
             }
-            if parsed.type.pluginTypeId == "Redis", !parsed.database.isEmpty {
-                additionalFieldValues["redisDatabase"] = parsed.database
+            if parsed.type.pluginTypeId == "Redis", let redisDb = parsed.redisDatabase {
+                additionalFieldValues["redisDatabase"] = String(redisDb)
+            }
+            if let svcName = parsed.oracleServiceName, !svcName.isEmpty {
+                additionalFieldValues["oracleServiceName"] = svcName
+            }
+            if let hex = parsed.statusColor, !hex.isEmpty {
+                connectionColor = ConnectionURLParser.connectionColor(fromHex: hex)
+            }
+            if let env = parsed.envTag, !env.isEmpty {
+                selectedTagId = ConnectionURLParser.tagId(fromEnvName: env)
+            }
+            if parsed.type.pluginTypeId == "libSQL", !parsed.host.isEmpty {
+                var urlString = "https://\(parsed.host)"
+                if let port = parsed.port {
+                    urlString += ":\(port)"
+                }
+                additionalFieldValues["databaseUrl"] = urlString
+            }
+            if parsed.type.pluginTypeId == "Cloudflare D1", !parsed.host.isEmpty {
+                additionalFieldValues["cfAccountId"] = parsed.host
             }
             if let connectionName = parsed.connectionName, !connectionName.isEmpty {
                 name = connectionName

TableProTests/Core/Utilities/ConnectionURLParserTests.swift

@@ -859,6 +859,62 @@ struct ConnectionURLParserTests {
         #expect(parsed.sshPort == 2222)
     }
 
+    // MARK: - DuckDB (file-based)
+
+    @Test("DuckDB absolute file path")
+    func testDuckDBAbsolutePath() {
+        let result = ConnectionURLParser.parse("duckdb:///Users/me/analytics.duckdb")
+        guard case .success(let parsed) = result else {
+            Issue.record("Expected success"); return
+        }
+        #expect(parsed.type == .duckdb)
+        #expect(parsed.database == "/Users/me/analytics.duckdb")
+        #expect(parsed.host == "")
+    }
+
+    @Test("DuckDB relative file path")
+    func testDuckDBRelativePath() {
+        let result = ConnectionURLParser.parse("duckdb://data.duckdb")
+        guard case .success(let parsed) = result else {
+            Issue.record("Expected success"); return
+        }
+        #expect(parsed.type == .duckdb)
+        #expect(parsed.database == "data.duckdb")
+    }
+
+    // MARK: - etcds TLS
+
+    @Test("etcds scheme enables SSL")
+    func testEtcdsSchemeEnablesSSL() {
+        let result = ConnectionURLParser.parse("etcds://host:2379")
+        guard case .success(let parsed) = result else {
+            Issue.record("Expected success"); return
+        }
+        #expect(parsed.sslMode == .required)
+    }
+
+    @Test("etcd scheme does not enable SSL")
+    func testEtcdSchemeNoSSL() {
+        let result = ConnectionURLParser.parse("etcd://host:2379")
+        guard case .success(let parsed) = result else {
+            Issue.record("Expected success"); return
+        }
+        #expect(parsed.sslMode == nil)
+    }
+
+    // MARK: - Oracle service name
+
+    @Test("Oracle URL extracts service name")
+    func testOracleServiceName() {
+        let result = ConnectionURLParser.parse("oracle://user:pass@host:1521/ORCL")
+        guard case .success(let parsed) = result else {
+            Issue.record("Expected success"); return
+        }
+        #expect(parsed.type == .oracle)
+        #expect(parsed.oracleServiceName == "ORCL")
+        #expect(parsed.database == "")
+    }
+
     @Test("SSH URL with both usePrivateKey and useSSHAgent prefers last")
     func testSSHURLWithBothPrivateKeyAndAgent() {
         let result = ConnectionURLParser.parse(

docs/databases/cassandra.mdx

@@ -21,7 +21,13 @@ Click **New Connection**, select **Cassandra** or **ScyllaDB**, enter host/port/
 | **Username** | - | Disable auth for local dev |
 | **Password** | - | |
 
-See [Connection URL Reference](/databases/connection-urls#cassandra--scylladb) for URL format.
+## Connection URL
+
+```text
+cassandra://user:password@host:9042/keyspace
+```
+
+See [Connection URL Reference](/databases/connection-urls#cassandra--scylladb) for all parameters.
 
 ## Example configurations
 

docs/databases/clickhouse.mdx

@@ -31,6 +31,14 @@ Uses HTTP API (HTTPS on port 8443 with SSL/TLS enabled). Cloud providers typical
 
 **SSL/TLS**: Enable in connection form for HTTPS (port 8443). Cloud requires HTTPS.
 
+## Connection URL
+
+```text
+clickhouse://user:password@host:8123/database
+```
+
+See [Connection URL Reference](/databases/connection-urls) for all parameters.
+
 ## Features
 
 ### Database Browsing