fix: use watched URL filters to update table filters

Author: arndom

packages/core/src/definitions/table/index.ts

@@ -186,3 +186,39 @@ export const getDefaultFilter = (
 
   return undefined;
 };
+
+export const mergeFilters = (
+  currentUrlFilters: CrudFilter[],
+  currentFilters: CrudFilter[],
+): CrudFilter[] => {
+  const mergedFilters = currentFilters.map((tableFilter) => {
+    const matchingURLFilter = currentUrlFilters.find(
+      (urlFilter) =>
+        "field" in tableFilter &&
+        "field" in urlFilter &&
+        tableFilter.field === urlFilter.field &&
+        tableFilter.operator === urlFilter.operator,
+    );
+
+    // override current filter wih url filter
+    if (matchingURLFilter) {
+      return { ...tableFilter, ...matchingURLFilter };
+    }
+
+    return tableFilter;
+  });
+
+  // add any other URL filters not in the current filters
+  const additionalURLFilters = currentUrlFilters.filter(
+    (urlFilter) =>
+      !currentFilters.some(
+        (tableFilter) =>
+          "field" in tableFilter &&
+          "field" in urlFilter &&
+          tableFilter.field === urlFilter.field &&
+          tableFilter.operator === urlFilter.operator,
+      ),
+  );
+
+  return [...mergedFilters, ...additionalURLFilters];
+};

packages/core/src/hooks/useTable/index.ts

@@ -11,6 +11,7 @@ import warnOnce from "warn-once";
 
 import { pickNotDeprecated } from "@definitions/helpers";
 import {
+  mergeFilters,
   parseTableParams,
   setInitialFilters,
   setInitialSorters,
@@ -439,27 +440,32 @@ export function useTable<
     return `${pathname ?? ""}?${stringifyParams ?? ""}`;
   };
 
+  // watch URL filters to update internal filters
   useEffect(() => {
-    if (!parsedParams?.params?.filters && !parsedParams?.params?.sorters) {
-      const resetFilters = setInitialFilters(
+    if (syncWithLocation) {
+      const current_filters = filters;
+      const current_URL_filters = parsedParams?.params?.filters;
+      const initial_filters = setInitialFilters(
         preferredPermanentFilters,
         defaultFilter ?? [],
       );
-      const resetSorters = setInitialSorters(
-        preferredPermanentSorters,
-        defaultSorter ?? [],
-      );
 
-      setFilters(resetFilters);
-      setSorters(resetSorters);
+      let new_filters: CrudFilter[] = [];
+      const urlsAreEqual = isEqual(current_URL_filters, current_filters);
+
+      if (!urlsAreEqual) {
+        // fallback to initial filters
+        if (!current_URL_filters || current_URL_filters.length === 0) {
+          new_filters = initial_filters;
+        } else {
+          // since they aren't equal, merge the two
+          new_filters = mergeFilters(current_URL_filters, current_filters);
+        }
+
+        setFilters(new_filters);
+      }
     }
-  }, [
-    parsedParams,
-    preferredPermanentFilters,
-    defaultFilter,
-    preferredPermanentSorters,
-    defaultSorter,
-  ]);
+  }, [parsedParams, filters, preferredPermanentFilters]);
 
   useEffect(() => {
     if (search === "") {