feat: pre-apply FK filter when navigating to referenced table

Author: datlechin

TablePro/Core/Services/Infrastructure/SessionStateFactory.swift

@@ -71,6 +71,10 @@ enum SessionStateFactory {
                         if payload.showStructure {
                             tabMgr.tabs[index].showStructure = true
                         }
+                        if let initialFilter = payload.initialFilterState {
+                            tabMgr.tabs[index].filterState = initialFilter
+                            filterMgr.restoreFromTabState(initialFilter)
+                        }
                     }
                 } else {
                     tabMgr.addTab(databaseName: payload.databaseName ?? connection.database)

TablePro/Models/Database/TableFilter.swift

@@ -71,7 +71,7 @@ enum FilterOperator: String, CaseIterable, Identifiable, Codable {
 }
 
 /// Represents a single table filter condition
-struct TableFilter: Identifiable, Equatable, Codable {
+struct TableFilter: Identifiable, Equatable, Hashable, Codable {
     let id: UUID
     var columnName: String          // Column to filter on, or "__RAW__" for raw SQL
     var filterOperator: FilterOperator
@@ -151,7 +151,7 @@ struct TableFilter: Identifiable, Equatable, Codable {
 }
 
 /// Stores per-tab filter state (preserves filters when switching tabs)
-struct TabFilterState: Equatable, Codable {
+struct TabFilterState: Equatable, Hashable, Codable {
     var filters: [TableFilter]
     var appliedFilters: [TableFilter]
     var isVisible: Bool

TablePro/Models/Query/EditorTabPayload.swift

@@ -31,6 +31,8 @@ internal struct EditorTabPayload: Codable, Hashable {
     internal let skipAutoExecute: Bool
     /// Whether this tab is a preview (temporary) tab
     internal let isPreview: Bool
+    /// Initial filter state (for FK navigation — pre-applies a WHERE filter)
+    internal let initialFilterState: TabFilterState?
 
     internal init(
         id: UUID = UUID(),
@@ -42,7 +44,8 @@ internal struct EditorTabPayload: Codable, Hashable {
         isView: Bool = false,
         showStructure: Bool = false,
         skipAutoExecute: Bool = false,
-        isPreview: Bool = false
+        isPreview: Bool = false,
+        initialFilterState: TabFilterState? = nil
     ) {
         self.id = id
         self.connectionId = connectionId
@@ -54,6 +57,7 @@ internal struct EditorTabPayload: Codable, Hashable {
         self.showStructure = showStructure
         self.skipAutoExecute = skipAutoExecute
         self.isPreview = isPreview
+        self.initialFilterState = initialFilterState
     }
 
     internal init(from decoder: Decoder) throws {
@@ -68,6 +72,7 @@ internal struct EditorTabPayload: Codable, Hashable {
         showStructure = try container.decodeIfPresent(Bool.self, forKey: .showStructure) ?? false
         skipAutoExecute = try container.decodeIfPresent(Bool.self, forKey: .skipAutoExecute) ?? false
         isPreview = try container.decodeIfPresent(Bool.self, forKey: .isPreview) ?? false
+        initialFilterState = try container.decodeIfPresent(TabFilterState.self, forKey: .initialFilterState)
     }
 
     /// Whether this payload is a "connection-only" payload — just a connectionId
@@ -89,5 +94,6 @@ internal struct EditorTabPayload: Codable, Hashable {
         self.showStructure = tab.showStructure
         self.skipAutoExecute = skipAutoExecute
         self.isPreview = false
+        self.initialFilterState = nil
     }
 }

TablePro/Resources/Localizable.xcstrings

@@ -13360,6 +13360,16 @@
         }
       }
     },
+    "Plugin was built with PluginKit version %lld, but version %lld or later is required. Please update the plugin." : {
+      "localizations" : {
+        "en" : {
+          "stringUnit" : {
+            "state" : "new",
+            "value" : "Plugin was built with PluginKit version %1$lld, but version %2$lld or later is required. Please update the plugin."
+          }
+        }
+      }
+    },
     "Plugins" : {
       "localizations" : {
         "vi" : {

TablePro/Views/Main/Extensions/MainContentCoordinator+FKNavigation.swift

@@ -52,12 +52,20 @@ extension MainContentCoordinator {
 
         // If current tab has unsaved changes, open in a new native tab instead of replacing
         if changeManager.hasChanges {
+            let fkFilterState = TabFilterState(
+                filters: [filter],
+                appliedFilters: [filter],
+                isVisible: true,
+                quickSearchText: "",
+                filterLogicMode: .and
+            )
             let payload = EditorTabPayload(
                 connectionId: connection.id,
                 tabType: .table,
                 tableName: referencedTable,
                 databaseName: currentDatabase,
-                isView: false
+                isView: false,
+                initialFilterState: fkFilterState
             )
             WindowOpener.shared.openNativeTab(payload)
             return

TablePro/Views/Main/MainContentView.swift

@@ -487,6 +487,19 @@ struct MainContentView: View {
                     {
                         Task { await coordinator.switchDatabase(to: selectedTab.databaseName) }
                     } else {
+                        if !selectedTab.filterState.appliedFilters.isEmpty,
+                           let tableName = selectedTab.tableName,
+                           let tabIndex = tabManager.selectedTabIndex
+                        {
+                            let filteredQuery = coordinator.queryBuilder.buildFilteredQuery(
+                                tableName: tableName,
+                                filters: selectedTab.filterState.appliedFilters,
+                                columns: selectedTab.resultColumns,
+                                limit: selectedTab.pagination.pageSize,
+                                offset: selectedTab.pagination.currentOffset
+                            )
+                            tabManager.tabs[tabIndex].query = filteredQuery
+                        }
                         coordinator.executeTableTabQueryDirectly()
                     }
                 } else {