@wordpress/views 1.6.0 → 1.6.1-next.v.20260206T143.0

package/README.md

@@ -23,20 +23,7 @@ npm install @wordpress/views --save
 
 ### loadView
 
-Async function for loading view state in route loaders with optional URL parameters.
-
-_Usage_
-
-```typescript
-// In route loader
-const view = await loadView( {
-	kind: 'taxonomy',
-	name: 'category',
-	slug: 'all',
-	defaultView,
-	queryParams: { page: search.page, search: search.search },
-} );
-```
+Async function for loading view state in route loaders.
 
 _Parameters_
 
@@ -45,6 +32,7 @@ _Parameters_
 -   _config.name_ `ViewConfig`: Specific entity name.
 -   _config.slug_ `ViewConfig`: View identifier.
 -   _config.defaultView_ `ViewConfig`: Default view configuration.
+-   _config.activeViewOverrides_ `ViewConfig`: View overrides applied on top but never persisted.
 -   _config.queryParams_ `ViewConfig`: Object with `page` and/or `search` from URL.
 
 _Returns_
@@ -58,12 +46,6 @@ Hook for managing DataViews view state with local persistence.
 _Parameters_
 
 -   _config_ `ViewConfig`: Configuration object for loading the view.
--   _config.kind_ `ViewConfig`: Entity kind (e.g., 'postType', 'taxonomy', 'root').
--   _config.name_ `ViewConfig`: Specific entity name.
--   _config.slug_ `ViewConfig`: View identifier.
--   _config.defaultView_ `ViewConfig`: Default view configuration.
--   _config.queryParams_ `ViewConfig`: Object with `page` and/or `search` from URL.
--   _config.onChangeQueryParams_ `ViewConfig`: Optional callback to update URL parameters.
 
 _Returns_
 

package/build/filter-utils.cjs

@@ -0,0 +1,84 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/views/src/filter-utils.ts
+var filter_utils_exports = {};
+__export(filter_utils_exports, {
+  mergeActiveViewOverrides: () => mergeActiveViewOverrides,
+  stripActiveViewOverrides: () => stripActiveViewOverrides
+});
+module.exports = __toCommonJS(filter_utils_exports);
+function mergeActiveViewOverrides(view, activeViewOverrides, defaultView) {
+  if (!activeViewOverrides) {
+    return view;
+  }
+  let result = view;
+  if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
+    const activeFields = new Set(
+      activeViewOverrides.filters.map((f) => f.field)
+    );
+    const preserved = (view.filters ?? []).filter(
+      (f) => !activeFields.has(f.field)
+    );
+    result = {
+      ...result,
+      filters: [...preserved, ...activeViewOverrides.filters]
+    };
+  }
+  if (activeViewOverrides.sort) {
+    const isDefaultSort = defaultView && view.sort?.field === defaultView.sort?.field && view.sort?.direction === defaultView.sort?.direction;
+    if (isDefaultSort) {
+      result = {
+        ...result,
+        sort: activeViewOverrides.sort
+      };
+    }
+  }
+  return result;
+}
+function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
+  if (!activeViewOverrides) {
+    return view;
+  }
+  let result = view;
+  if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
+    const activeFields = new Set(
+      activeViewOverrides.filters.map((f) => f.field)
+    );
+    result = {
+      ...result,
+      filters: (view.filters ?? []).filter(
+        (f) => !activeFields.has(f.field)
+      )
+    };
+  }
+  if (activeViewOverrides.sort && view.sort?.field === activeViewOverrides.sort.field && view.sort?.direction === activeViewOverrides.sort.direction) {
+    result = {
+      ...result,
+      sort: defaultView?.sort
+    };
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  mergeActiveViewOverrides,
+  stripActiveViewOverrides
+});
+//# sourceMappingURL=filter-utils.cjs.map

package/build/filter-utils.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/filter-utils.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport type { View, Filter } from '@wordpress/dataviews';\n\ntype ActiveViewOverrides = {\n\tfilters?: Filter[];\n\tsort?: View[ 'sort' ];\n};\n\n/**\n * Merges activeViewOverrides into a view.\n * Filters: Active filters take precedence; same-field filters are replaced.\n * Sort: Active sort is applied only if current sort matches the default.\n *\n * @param view                The view to merge overrides into.\n * @param activeViewOverrides The tab-specific overrides to apply.\n * @param defaultView         The default view configuration.\n * @return A new view with merged overrides, or the original view if no overrides.\n */\nexport function mergeActiveViewOverrides(\n\tview: View,\n\tactiveViewOverrides?: ActiveViewOverrides,\n\tdefaultView?: View\n): View {\n\tif ( ! activeViewOverrides ) {\n\t\treturn view;\n\t}\n\n\tlet result = view;\n\n\t// Merge filters\n\tif (\n\t\tactiveViewOverrides.filters &&\n\t\tactiveViewOverrides.filters.length > 0\n\t) {\n\t\tconst activeFields = new Set(\n\t\t\tactiveViewOverrides.filters.map( ( f ) => f.field )\n\t\t);\n\t\tconst preserved = ( view.filters ?? [] ).filter(\n\t\t\t( f: Filter ) => ! activeFields.has( f.field )\n\t\t);\n\t\tresult = {\n\t\t\t...result,\n\t\t\tfilters: [ ...preserved, ...activeViewOverrides.filters ],\n\t\t};\n\t}\n\n\t// Merge sort - only apply if the current sort matches the default\n\tif ( activeViewOverrides.sort ) {\n\t\tconst isDefaultSort =\n\t\t\tdefaultView &&\n\t\t\tview.sort?.field === defaultView.sort?.field &&\n\t\t\tview.sort?.direction === defaultView.sort?.direction;\n\n\t\tif ( isDefaultSort ) {\n\t\t\tresult = {\n\t\t\t\t...result,\n\t\t\t\tsort: activeViewOverrides.sort,\n\t\t\t};\n\t\t}\n\t}\n\n\treturn result;\n}\n\n/**\n * Strips overrides before persisting.\n * Filters: Removes filters on fields managed by activeViewOverrides.\n * Sort: If sort matches the override, restores the default sort.\n *\n * @param view                The view to strip overrides from.\n * @param activeViewOverrides The tab-specific override definitions.\n * @param defaultView         The default view configuration.\n * @return A new view with overrides stripped, or the original view if no overrides.\n */\nexport function stripActiveViewOverrides(\n\tview: View,\n\tactiveViewOverrides?: ActiveViewOverrides,\n\tdefaultView?: View\n): View {\n\tif ( ! activeViewOverrides ) {\n\t\treturn view;\n\t}\n\n\tlet result = view;\n\n\t// Strip managed filters\n\tif (\n\t\tactiveViewOverrides.filters &&\n\t\tactiveViewOverrides.filters.length > 0\n\t) {\n\t\tconst activeFields = new Set(\n\t\t\tactiveViewOverrides.filters.map( ( f ) => f.field )\n\t\t);\n\t\tresult = {\n\t\t\t...result,\n\t\t\tfilters: ( view.filters ?? [] ).filter(\n\t\t\t\t( f: Filter ) => ! activeFields.has( f.field )\n\t\t\t),\n\t\t};\n\t}\n\n\t// Strip sort if it matches the override (restore to default)\n\tif (\n\t\tactiveViewOverrides.sort &&\n\t\tview.sort?.field === activeViewOverrides.sort.field &&\n\t\tview.sort?.direction === activeViewOverrides.sort.direction\n\t) {\n\t\tresult = {\n\t\t\t...result,\n\t\t\tsort: defaultView?.sort,\n\t\t};\n\t}\n\n\treturn result;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBO,SAAS,yBACf,MACA,qBACA,aACO;AACP,MAAK,CAAE,qBAAsB;AAC5B,WAAO;AAAA,EACR;AAEA,MAAI,SAAS;AAGb,MACC,oBAAoB,WACpB,oBAAoB,QAAQ,SAAS,GACpC;AACD,UAAM,eAAe,IAAI;AAAA,MACxB,oBAAoB,QAAQ,IAAK,CAAE,MAAO,EAAE,KAAM;AAAA,IACnD;AACA,UAAM,aAAc,KAAK,WAAW,CAAC,GAAI;AAAA,MACxC,CAAE,MAAe,CAAE,aAAa,IAAK,EAAE,KAAM;AAAA,IAC9C;AACA,aAAS;AAAA,MACR,GAAG;AAAA,MACH,SAAS,CAAE,GAAG,WAAW,GAAG,oBAAoB,OAAQ;AAAA,IACzD;AAAA,EACD;AAGA,MAAK,oBAAoB,MAAO;AAC/B,UAAM,gBACL,eACA,KAAK,MAAM,UAAU,YAAY,MAAM,SACvC,KAAK,MAAM,cAAc,YAAY,MAAM;AAE5C,QAAK,eAAgB;AACpB,eAAS;AAAA,QACR,GAAG;AAAA,QACH,MAAM,oBAAoB;AAAA,MAC3B;AAAA,IACD;AAAA,EACD;AAEA,SAAO;AACR;AAYO,SAAS,yBACf,MACA,qBACA,aACO;AACP,MAAK,CAAE,qBAAsB;AAC5B,WAAO;AAAA,EACR;AAEA,MAAI,SAAS;AAGb,MACC,oBAAoB,WACpB,oBAAoB,QAAQ,SAAS,GACpC;AACD,UAAM,eAAe,IAAI;AAAA,MACxB,oBAAoB,QAAQ,IAAK,CAAE,MAAO,EAAE,KAAM;AAAA,IACnD;AACA,aAAS;AAAA,MACR,GAAG;AAAA,MACH,UAAW,KAAK,WAAW,CAAC,GAAI;AAAA,QAC/B,CAAE,MAAe,CAAE,aAAa,IAAK,EAAE,KAAM;AAAA,MAC9C;AAAA,IACD;AAAA,EACD;AAGA,MACC,oBAAoB,QACpB,KAAK,MAAM,UAAU,oBAAoB,KAAK,SAC9C,KAAK,MAAM,cAAc,oBAAoB,KAAK,WACjD;AACD,aAAS;AAAA,MACR,GAAG;AAAA,MACH,MAAM,aAAa;AAAA,IACpB;AAAA,EACD;AAEA,SAAO;AACR;",
+  "names": []
+}

package/build/load-view.cjs

@@ -26,8 +26,9 @@ module.exports = __toCommonJS(load_view_exports);
 var import_data = require("@wordpress/data");
 var import_preferences = require("@wordpress/preferences");
 var import_preference_keys = require("./preference-keys.cjs");
+var import_filter_utils = require("./filter-utils.cjs");
 async function loadView(config) {
-  const { kind, name, slug, defaultView, queryParams } = config;
+  const { kind, name, slug, defaultView, activeViewOverrides, queryParams } = config;
   const preferenceKey = (0, import_preference_keys.generatePreferenceKey)(kind, name, slug);
   const persistedView = (0, import_data.select)(import_preferences.store).get(
     "core/views",
@@ -36,11 +37,15 @@ async function loadView(config) {
   const baseView = persistedView ?? defaultView;
   const page = queryParams?.page ?? 1;
   const search = queryParams?.search ?? "";
-  return {
-    ...baseView,
-    page,
-    search
-  };
+  return (0, import_filter_utils.mergeActiveViewOverrides)(
+    {
+      ...baseView,
+      page,
+      search
+    },
+    activeViewOverrides,
+    defaultView
+  );
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/build/load-view.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/load-view.ts"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { select } from '@wordpress/data';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\nimport type { View } from '@wordpress/dataviews';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport type { ViewConfig } from './types';\n\n/**\n * Async function for loading view state in route loaders with optional URL parameters.\n *\n * @example\n *\n * ```typescript\n * // In route loader\n * const view = await loadView( {\n * \tkind: 'taxonomy',\n * \tname: 'category',\n * \tslug: 'all',\n * \tdefaultView,\n * \tqueryParams: { page: search.page, search: search.search },\n * } );\n * ```\n *\n * @param config             Configuration object for loading the view.\n * @param config.kind        Entity kind (e.g., 'postType', 'taxonomy', 'root').\n * @param config.name        Specific entity name.\n * @param config.slug        View identifier.\n * @param config.defaultView Default view configuration.\n * @param config.queryParams Object with `page` and/or `search` from URL.\n *\n * @return Promise resolving to the loaded view object.\n */\nexport async function loadView( config: ViewConfig ) {\n\tconst { kind, name, slug, defaultView, queryParams } = config;\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = select( preferencesStore ).get(\n\t\t'core/views',\n\t\tpreferenceKey\n\t) as View | undefined;\n\n\tconst baseView = persistedView ?? defaultView;\n\tconst page = queryParams?.page ?? 1;\n\tconst search = queryParams?.search ?? '';\n\n\treturn {\n\t\t...baseView,\n\t\tpage,\n\t\tsearch,\n\t};\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAAuB;AAEvB,yBAA0C;AAM1C,6BAAsC;AA4BtC,eAAsB,SAAU,QAAqB;AACpD,QAAM,EAAE,MAAM,MAAM,MAAM,aAAa,YAAY,IAAI;AACvD,QAAM,oBAAgB,8CAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,oBAAkC,oBAAQ,mBAAAA,KAAiB,EAAE;AAAA,IAClE;AAAA,IACA;AAAA,EACD;AAEA,QAAM,WAAW,iBAAiB;AAClC,QAAM,OAAO,aAAa,QAAQ;AAClC,QAAM,SAAS,aAAa,UAAU;AAEtC,SAAO;AAAA,IACN,GAAG;AAAA,IACH;AAAA,IACA;AAAA,EACD;AACD;",
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { select } from '@wordpress/data';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\nimport type { View } from '@wordpress/dataviews';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport { mergeActiveViewOverrides } from './filter-utils';\nimport type { ViewConfig } from './types';\n\n/**\n * Async function for loading view state in route loaders.\n *\n * @param config                     Configuration object for loading the view.\n * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').\n * @param config.name                Specific entity name.\n * @param config.slug                View identifier.\n * @param config.defaultView         Default view configuration.\n * @param config.activeViewOverrides View overrides applied on top but never persisted.\n * @param config.queryParams         Object with `page` and/or `search` from URL.\n * @return Promise resolving to the loaded view object.\n */\nexport async function loadView( config: ViewConfig ) {\n\tconst { kind, name, slug, defaultView, activeViewOverrides, queryParams } =\n\t\tconfig;\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = select( preferencesStore ).get(\n\t\t'core/views',\n\t\tpreferenceKey\n\t) as View | undefined;\n\n\tconst baseView = persistedView ?? defaultView;\n\tconst page = queryParams?.page ?? 1;\n\tconst search = queryParams?.search ?? '';\n\n\treturn mergeActiveViewOverrides(\n\t\t{\n\t\t\t...baseView,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t},\n\t\tactiveViewOverrides,\n\t\tdefaultView\n\t);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,kBAAuB;AAEvB,yBAA0C;AAM1C,6BAAsC;AACtC,0BAAyC;AAezC,eAAsB,SAAU,QAAqB;AACpD,QAAM,EAAE,MAAM,MAAM,MAAM,aAAa,qBAAqB,YAAY,IACvE;AACD,QAAM,oBAAgB,8CAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,oBAAkC,oBAAQ,mBAAAA,KAAiB,EAAE;AAAA,IAClE;AAAA,IACA;AAAA,EACD;AAEA,QAAM,WAAW,iBAAiB;AAClC,QAAM,OAAO,aAAa,QAAQ;AAClC,QAAM,SAAS,aAAa,UAAU;AAEtC,aAAO;AAAA,IACN;AAAA,MACC,GAAG;AAAA,MACH;AAAA,MACA;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;",
   "names": ["preferencesStore"]
 }

package/build/types.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/types.ts"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport type { View } from '@wordpress/dataviews';\n\nexport interface ViewConfig {\n\t/**\n\t * Entity kind (e.g. postType, root).\n\t * Similar to core-data entity kinds.\n\t */\n\tkind: string;\n\n\t/**\n\t * Entity name (e.g. post, page, user, site).\n\t * Similar to core-data entity names.\n\t */\n\tname: string;\n\n\t/**\n\t * Identifier for the current view (all, published, mine, etc.)\n\t */\n\tslug: string;\n\n\t/**\n\t * Default view configuration\n\t */\n\tdefaultView: View;\n\n\t/**\n\t * Optional query parameters from URL (page, search)\n\t */\n\tqueryParams?: {\n\t\tpage?: number;\n\t\tsearch?: string;\n\t};\n\n\t/**\n\t * Callback for when URL query parameters should change\n\t */\n\tonChangeQueryParams?: ( params: {\n\t\tpage?: number;\n\t\tsearch?: string;\n\t} ) => void;\n}\n"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport type { View, Filter } from '@wordpress/dataviews';\n\nexport interface ViewConfig {\n\t/**\n\t * Entity kind (e.g. postType, root).\n\t * Similar to core-data entity kinds.\n\t */\n\tkind: string;\n\n\t/**\n\t * Entity name (e.g. post, page, user, site).\n\t * Similar to core-data entity names.\n\t */\n\tname: string;\n\n\t/**\n\t * Identifier for the current view (all, published, mine, etc.)\n\t */\n\tslug: string;\n\n\t/**\n\t * Default view configuration\n\t */\n\tdefaultView: View;\n\n\t/**\n\t * View overrides applied on top of the persisted view but never persisted.\n\t * These represent tab-specific configuration (filters, sort) that should\n\t * override the persisted view settings.\n\t */\n\tactiveViewOverrides?: {\n\t\tfilters?: Filter[];\n\t\tsort?: View[ 'sort' ];\n\t};\n\n\t/**\n\t * Optional query parameters from URL (page, search)\n\t */\n\tqueryParams?: {\n\t\tpage?: number;\n\t\tsearch?: string;\n\t};\n\n\t/**\n\t * Callback for when URL query parameters should change\n\t */\n\tonChangeQueryParams?: ( params: {\n\t\tpage?: number;\n\t\tsearch?: string;\n\t} ) => void;\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;;AAAA;AAAA;",
   "names": []
 }

package/build/use-view.cjs

@@ -24,10 +24,11 @@ __export(use_view_exports, {
 });
 module.exports = __toCommonJS(use_view_exports);
 var import_dequal = require("dequal");
-var import_preference_keys = require("./preference-keys.cjs");
 var import_element = require("@wordpress/element");
 var import_data = require("@wordpress/data");
 var import_preferences = require("@wordpress/preferences");
+var import_preference_keys = require("./preference-keys.cjs");
+var import_filter_utils = require("./filter-utils.cjs");
 function omit(obj, keys) {
   const result = { ...obj };
   for (const key of keys) {
@@ -36,7 +37,15 @@ function omit(obj, keys) {
   return result;
 }
 function useView(config) {
-  const { kind, name, slug, defaultView, queryParams, onChangeQueryParams } = config;
+  const {
+    kind,
+    name,
+    slug,
+    defaultView,
+    activeViewOverrides,
+    queryParams,
+    onChangeQueryParams
+  } = config;
   const preferenceKey = (0, import_preference_keys.generatePreferenceKey)(kind, name, slug);
   const persistedView = (0, import_data.useSelect)(
     (select) => {
@@ -52,12 +61,16 @@ function useView(config) {
   const page = Number(queryParams?.page ?? baseView.page ?? 1);
   const search = queryParams?.search ?? baseView.search ?? "";
   const view = (0, import_element.useMemo)(() => {
-    return {
-      ...baseView,
-      page,
-      search
-    };
-  }, [baseView, page, search]);
+    return (0, import_filter_utils.mergeActiveViewOverrides)(
+      {
+        ...baseView,
+        page,
+        search
+      },
+      activeViewOverrides,
+      defaultView
+    );
+  }, [baseView, page, search, activeViewOverrides, defaultView]);
   const isModified = !!persistedView;
   const updateView = (0, import_element.useCallback)(
     (newView) => {
@@ -65,12 +78,26 @@ function useView(config) {
         page: newView?.page,
         search: newView?.search
       };
-      const preferenceView = omit(newView, ["page", "search"]);
+      const preferenceView = (0, import_filter_utils.stripActiveViewOverrides)(
+        omit(newView, ["page", "search"]),
+        activeViewOverrides,
+        defaultView
+      );
       if (onChangeQueryParams && !(0, import_dequal.dequal)(urlParams, { page, search })) {
         onChangeQueryParams(urlParams);
       }
-      if (!(0, import_dequal.dequal)(baseView, preferenceView)) {
-        if ((0, import_dequal.dequal)(preferenceView, defaultView)) {
+      const comparableBaseView = (0, import_filter_utils.stripActiveViewOverrides)(
+        baseView,
+        activeViewOverrides,
+        defaultView
+      );
+      const comparableDefaultView = (0, import_filter_utils.stripActiveViewOverrides)(
+        defaultView,
+        activeViewOverrides,
+        defaultView
+      );
+      if (!(0, import_dequal.dequal)(comparableBaseView, preferenceView)) {
+        if ((0, import_dequal.dequal)(preferenceView, comparableDefaultView)) {
           set("core/views", preferenceKey, void 0);
         } else {
           set("core/views", preferenceKey, preferenceView);
@@ -83,6 +110,7 @@ function useView(config) {
       search,
       baseView,
       defaultView,
+      activeViewOverrides,
       set,
       preferenceKey
     ]

package/build/use-view.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/use-view.ts"],
-  "sourcesContent": ["/**\n * External dependencies\n */\nimport { dequal } from 'dequal';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport type { ViewConfig } from './types';\n\n/**\n * WordPress dependencies\n */\nimport { useCallback, useMemo } from '@wordpress/element';\nimport { useDispatch, useSelect } from '@wordpress/data';\nimport type { View } from '@wordpress/dataviews';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\n\ninterface UseViewReturn {\n\tview: View;\n\tisModified: boolean;\n\tupdateView: ( newView: View ) => void;\n\tresetToDefault: () => void;\n}\n\nfunction omit< T extends object, K extends keyof T >(\n\tobj: T,\n\tkeys: K[]\n): Omit< T, K > {\n\tconst result = { ...obj };\n\tfor ( const key of keys ) {\n\t\tdelete result[ key ];\n\t}\n\treturn result;\n}\n\n/**\n * Hook for managing DataViews view state with local persistence.\n *\n * @param config                     Configuration object for loading the view.\n * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').\n * @param config.name                Specific entity name.\n * @param config.slug                View identifier.\n * @param config.defaultView         Default view configuration.\n * @param config.queryParams         Object with `page` and/or `search` from URL.\n * @param config.onChangeQueryParams Optional callback to update URL parameters.\n *\n * @return Object with current view, modification state, and update functions.\n */\nexport function useView( config: ViewConfig ): UseViewReturn {\n\tconst { kind, name, slug, defaultView, queryParams, onChangeQueryParams } =\n\t\tconfig;\n\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = useSelect(\n\t\t( select ) => {\n\t\t\treturn select( preferencesStore ).get(\n\t\t\t\t'core/views',\n\t\t\t\tpreferenceKey\n\t\t\t) as View | undefined;\n\t\t},\n\t\t[ preferenceKey ]\n\t);\n\tconst { set } = useDispatch( preferencesStore );\n\n\tconst baseView: View = persistedView ?? defaultView;\n\tconst page = Number( queryParams?.page ?? baseView.page ?? 1 );\n\tconst search = queryParams?.search ?? baseView.search ?? '';\n\n\t// Merge URL query parameters (page, search) into the view\n\tconst view: View = useMemo( () => {\n\t\treturn {\n\t\t\t...baseView,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t};\n\t}, [ baseView, page, search ] );\n\n\tconst isModified = !! persistedView;\n\n\tconst updateView = useCallback(\n\t\t( newView: View ) => {\n\t\t\t// Extract URL params (page, search) from the new view\n\t\t\tconst urlParams: { page?: number; search?: string } = {\n\t\t\t\tpage: newView?.page,\n\t\t\t\tsearch: newView?.search,\n\t\t\t};\n\t\t\tconst preferenceView = omit( newView, [ 'page', 'search' ] );\n\n\t\t\t// If we have URL handling enabled, separate URL state from preference state\n\t\t\tif (\n\t\t\t\tonChangeQueryParams &&\n\t\t\t\t! dequal( urlParams, { page, search } )\n\t\t\t) {\n\t\t\t\tonChangeQueryParams( urlParams );\n\t\t\t}\n\n\t\t\t// Only persist non-URL preferences if different from baseView\n\t\t\tif ( ! dequal( baseView, preferenceView ) ) {\n\t\t\t\tif ( dequal( preferenceView, defaultView ) ) {\n\t\t\t\t\tset( 'core/views', preferenceKey, undefined );\n\t\t\t\t} else {\n\t\t\t\t\tset( 'core/views', preferenceKey, preferenceView );\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t[\n\t\t\tonChangeQueryParams,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t\tbaseView,\n\t\t\tdefaultView,\n\t\t\tset,\n\t\t\tpreferenceKey,\n\t\t]\n\t);\n\n\tconst resetToDefault = useCallback( () => {\n\t\tset( 'core/views', preferenceKey, undefined );\n\t}, [ preferenceKey, set ] );\n\n\treturn {\n\t\tview,\n\t\tisModified,\n\t\tupdateView,\n\t\tresetToDefault,\n\t};\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAAuB;AAKvB,6BAAsC;AAMtC,qBAAqC;AACrC,kBAAuC;AAGvC,yBAA0C;AAS1C,SAAS,KACR,KACA,MACe;AACf,QAAM,SAAS,EAAE,GAAG,IAAI;AACxB,aAAY,OAAO,MAAO;AACzB,WAAO,OAAQ,GAAI;AAAA,EACpB;AACA,SAAO;AACR;AAeO,SAAS,QAAS,QAAoC;AAC5D,QAAM,EAAE,MAAM,MAAM,MAAM,aAAa,aAAa,oBAAoB,IACvE;AAED,QAAM,oBAAgB,8CAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,oBAAkC;AAAA,IACvC,CAAE,WAAY;AACb,aAAO,OAAQ,mBAAAA,KAAiB,EAAE;AAAA,QACjC;AAAA,QACA;AAAA,MACD;AAAA,IACD;AAAA,IACA,CAAE,aAAc;AAAA,EACjB;AACA,QAAM,EAAE,IAAI,QAAI,yBAAa,mBAAAA,KAAiB;AAE9C,QAAM,WAAiB,iBAAiB;AACxC,QAAM,OAAO,OAAQ,aAAa,QAAQ,SAAS,QAAQ,CAAE;AAC7D,QAAM,SAAS,aAAa,UAAU,SAAS,UAAU;AAGzD,QAAM,WAAa,wBAAS,MAAM;AACjC,WAAO;AAAA,MACN,GAAG;AAAA,MACH;AAAA,MACA;AAAA,IACD;AAAA,EACD,GAAG,CAAE,UAAU,MAAM,MAAO,CAAE;AAE9B,QAAM,aAAa,CAAC,CAAE;AAEtB,QAAM,iBAAa;AAAA,IAClB,CAAE,YAAmB;AAEpB,YAAM,YAAgD;AAAA,QACrD,MAAM,SAAS;AAAA,QACf,QAAQ,SAAS;AAAA,MAClB;AACA,YAAM,iBAAiB,KAAM,SAAS,CAAE,QAAQ,QAAS,CAAE;AAG3D,UACC,uBACA,KAAE,sBAAQ,WAAW,EAAE,MAAM,OAAO,CAAE,GACrC;AACD,4BAAqB,SAAU;AAAA,MAChC;AAGA,UAAK,KAAE,sBAAQ,UAAU,cAAe,GAAI;AAC3C,gBAAK,sBAAQ,gBAAgB,WAAY,GAAI;AAC5C,cAAK,cAAc,eAAe,MAAU;AAAA,QAC7C,OAAO;AACN,cAAK,cAAc,eAAe,cAAe;AAAA,QAClD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD;AAEA,QAAM,qBAAiB,4BAAa,MAAM;AACzC,QAAK,cAAc,eAAe,MAAU;AAAA,EAC7C,GAAG,CAAE,eAAe,GAAI,CAAE;AAE1B,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;",
+  "sourcesContent": ["/**\n * External dependencies\n */\nimport { dequal } from 'dequal';\n\n/**\n * WordPress dependencies\n */\nimport { useCallback, useMemo } from '@wordpress/element';\nimport { useDispatch, useSelect } from '@wordpress/data';\nimport type { View } from '@wordpress/dataviews';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport {\n\tmergeActiveViewOverrides,\n\tstripActiveViewOverrides,\n} from './filter-utils';\nimport type { ViewConfig } from './types';\n\ninterface UseViewReturn {\n\tview: View;\n\tisModified: boolean;\n\tupdateView: ( newView: View ) => void;\n\tresetToDefault: () => void;\n}\n\nfunction omit< T extends object, K extends keyof T >(\n\tobj: T,\n\tkeys: K[]\n): Omit< T, K > {\n\tconst result = { ...obj };\n\tfor ( const key of keys ) {\n\t\tdelete result[ key ];\n\t}\n\treturn result;\n}\n\n/**\n * Hook for managing DataViews view state with local persistence.\n *\n * @param config Configuration object for loading the view.\n *\n * @return Object with current view, modification state, and update functions.\n */\nexport function useView( config: ViewConfig ): UseViewReturn {\n\tconst {\n\t\tkind,\n\t\tname,\n\t\tslug,\n\t\tdefaultView,\n\t\tactiveViewOverrides,\n\t\tqueryParams,\n\t\tonChangeQueryParams,\n\t} = config;\n\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = useSelect(\n\t\t( select ) => {\n\t\t\treturn select( preferencesStore ).get(\n\t\t\t\t'core/views',\n\t\t\t\tpreferenceKey\n\t\t\t) as View | undefined;\n\t\t},\n\t\t[ preferenceKey ]\n\t);\n\tconst { set } = useDispatch( preferencesStore );\n\n\tconst baseView: View = persistedView ?? defaultView;\n\tconst page = Number( queryParams?.page ?? baseView.page ?? 1 );\n\tconst search = queryParams?.search ?? baseView.search ?? '';\n\n\t// Merge URL query parameters (page, search) and activeViewOverrides into the view\n\tconst view: View = useMemo( () => {\n\t\treturn mergeActiveViewOverrides(\n\t\t\t{\n\t\t\t\t...baseView,\n\t\t\t\tpage,\n\t\t\t\tsearch,\n\t\t\t},\n\t\t\tactiveViewOverrides,\n\t\t\tdefaultView\n\t\t);\n\t}, [ baseView, page, search, activeViewOverrides, defaultView ] );\n\n\tconst isModified = !! persistedView;\n\n\tconst updateView = useCallback(\n\t\t( newView: View ) => {\n\t\t\t// Extract URL params (page, search) from the new view\n\t\t\tconst urlParams: { page?: number; search?: string } = {\n\t\t\t\tpage: newView?.page,\n\t\t\t\tsearch: newView?.search,\n\t\t\t};\n\t\t\t// Strip activeViewOverrides and URL params before persisting\n\t\t\t// Cast is safe: omitting page/search doesn't change the discriminant (type field)\n\t\t\tconst preferenceView = stripActiveViewOverrides(\n\t\t\t\tomit( newView, [ 'page', 'search' ] ) as View,\n\t\t\t\tactiveViewOverrides,\n\t\t\t\tdefaultView\n\t\t\t);\n\n\t\t\t// If we have URL handling enabled, separate URL state from preference state\n\t\t\tif (\n\t\t\t\tonChangeQueryParams &&\n\t\t\t\t! dequal( urlParams, { page, search } )\n\t\t\t) {\n\t\t\t\tonChangeQueryParams( urlParams );\n\t\t\t}\n\n\t\t\t// Compare with baseView and defaultView after stripping activeViewOverrides\n\t\t\tconst comparableBaseView = stripActiveViewOverrides(\n\t\t\t\tbaseView,\n\t\t\t\tactiveViewOverrides,\n\t\t\t\tdefaultView\n\t\t\t);\n\t\t\tconst comparableDefaultView = stripActiveViewOverrides(\n\t\t\t\tdefaultView,\n\t\t\t\tactiveViewOverrides,\n\t\t\t\tdefaultView\n\t\t\t);\n\n\t\t\t// Only persist non-URL preferences if different from baseView\n\t\t\tif ( ! dequal( comparableBaseView, preferenceView ) ) {\n\t\t\t\tif ( dequal( preferenceView, comparableDefaultView ) ) {\n\t\t\t\t\tset( 'core/views', preferenceKey, undefined );\n\t\t\t\t} else {\n\t\t\t\t\tset( 'core/views', preferenceKey, preferenceView );\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t[\n\t\t\tonChangeQueryParams,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t\tbaseView,\n\t\t\tdefaultView,\n\t\t\tactiveViewOverrides,\n\t\t\tset,\n\t\t\tpreferenceKey,\n\t\t]\n\t);\n\n\tconst resetToDefault = useCallback( () => {\n\t\tset( 'core/views', preferenceKey, undefined );\n\t}, [ preferenceKey, set ] );\n\n\treturn {\n\t\tview,\n\t\tisModified,\n\t\tupdateView,\n\t\tresetToDefault,\n\t};\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAGA,oBAAuB;AAKvB,qBAAqC;AACrC,kBAAuC;AAGvC,yBAA0C;AAK1C,6BAAsC;AACtC,0BAGO;AAUP,SAAS,KACR,KACA,MACe;AACf,QAAM,SAAS,EAAE,GAAG,IAAI;AACxB,aAAY,OAAO,MAAO;AACzB,WAAO,OAAQ,GAAI;AAAA,EACpB;AACA,SAAO;AACR;AASO,SAAS,QAAS,QAAoC;AAC5D,QAAM;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD,IAAI;AAEJ,QAAM,oBAAgB,8CAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,oBAAkC;AAAA,IACvC,CAAE,WAAY;AACb,aAAO,OAAQ,mBAAAA,KAAiB,EAAE;AAAA,QACjC;AAAA,QACA;AAAA,MACD;AAAA,IACD;AAAA,IACA,CAAE,aAAc;AAAA,EACjB;AACA,QAAM,EAAE,IAAI,QAAI,yBAAa,mBAAAA,KAAiB;AAE9C,QAAM,WAAiB,iBAAiB;AACxC,QAAM,OAAO,OAAQ,aAAa,QAAQ,SAAS,QAAQ,CAAE;AAC7D,QAAM,SAAS,aAAa,UAAU,SAAS,UAAU;AAGzD,QAAM,WAAa,wBAAS,MAAM;AACjC,eAAO;AAAA,MACN;AAAA,QACC,GAAG;AAAA,QACH;AAAA,QACA;AAAA,MACD;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD,GAAG,CAAE,UAAU,MAAM,QAAQ,qBAAqB,WAAY,CAAE;AAEhE,QAAM,aAAa,CAAC,CAAE;AAEtB,QAAM,iBAAa;AAAA,IAClB,CAAE,YAAmB;AAEpB,YAAM,YAAgD;AAAA,QACrD,MAAM,SAAS;AAAA,QACf,QAAQ,SAAS;AAAA,MAClB;AAGA,YAAM,qBAAiB;AAAA,QACtB,KAAM,SAAS,CAAE,QAAQ,QAAS,CAAE;AAAA,QACpC;AAAA,QACA;AAAA,MACD;AAGA,UACC,uBACA,KAAE,sBAAQ,WAAW,EAAE,MAAM,OAAO,CAAE,GACrC;AACD,4BAAqB,SAAU;AAAA,MAChC;AAGA,YAAM,yBAAqB;AAAA,QAC1B;AAAA,QACA;AAAA,QACA;AAAA,MACD;AACA,YAAM,4BAAwB;AAAA,QAC7B;AAAA,QACA;AAAA,QACA;AAAA,MACD;AAGA,UAAK,KAAE,sBAAQ,oBAAoB,cAAe,GAAI;AACrD,gBAAK,sBAAQ,gBAAgB,qBAAsB,GAAI;AACtD,cAAK,cAAc,eAAe,MAAU;AAAA,QAC7C,OAAO;AACN,cAAK,cAAc,eAAe,cAAe;AAAA,QAClD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD;AAEA,QAAM,qBAAiB,4BAAa,MAAM;AACzC,QAAK,cAAc,eAAe,MAAU;AAAA,EAC7C,GAAG,CAAE,eAAe,GAAI,CAAE;AAE1B,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;",
   "names": ["preferencesStore"]
 }

package/build-module/filter-utils.mjs

@@ -0,0 +1,58 @@
+// packages/views/src/filter-utils.ts
+function mergeActiveViewOverrides(view, activeViewOverrides, defaultView) {
+  if (!activeViewOverrides) {
+    return view;
+  }
+  let result = view;
+  if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
+    const activeFields = new Set(
+      activeViewOverrides.filters.map((f) => f.field)
+    );
+    const preserved = (view.filters ?? []).filter(
+      (f) => !activeFields.has(f.field)
+    );
+    result = {
+      ...result,
+      filters: [...preserved, ...activeViewOverrides.filters]
+    };
+  }
+  if (activeViewOverrides.sort) {
+    const isDefaultSort = defaultView && view.sort?.field === defaultView.sort?.field && view.sort?.direction === defaultView.sort?.direction;
+    if (isDefaultSort) {
+      result = {
+        ...result,
+        sort: activeViewOverrides.sort
+      };
+    }
+  }
+  return result;
+}
+function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
+  if (!activeViewOverrides) {
+    return view;
+  }
+  let result = view;
+  if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
+    const activeFields = new Set(
+      activeViewOverrides.filters.map((f) => f.field)
+    );
+    result = {
+      ...result,
+      filters: (view.filters ?? []).filter(
+        (f) => !activeFields.has(f.field)
+      )
+    };
+  }
+  if (activeViewOverrides.sort && view.sort?.field === activeViewOverrides.sort.field && view.sort?.direction === activeViewOverrides.sort.direction) {
+    result = {
+      ...result,
+      sort: defaultView?.sort
+    };
+  }
+  return result;
+}
+export {
+  mergeActiveViewOverrides,
+  stripActiveViewOverrides
+};
+//# sourceMappingURL=filter-utils.mjs.map

package/build-module/filter-utils.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/filter-utils.ts"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport type { View, Filter } from '@wordpress/dataviews';\n\ntype ActiveViewOverrides = {\n\tfilters?: Filter[];\n\tsort?: View[ 'sort' ];\n};\n\n/**\n * Merges activeViewOverrides into a view.\n * Filters: Active filters take precedence; same-field filters are replaced.\n * Sort: Active sort is applied only if current sort matches the default.\n *\n * @param view                The view to merge overrides into.\n * @param activeViewOverrides The tab-specific overrides to apply.\n * @param defaultView         The default view configuration.\n * @return A new view with merged overrides, or the original view if no overrides.\n */\nexport function mergeActiveViewOverrides(\n\tview: View,\n\tactiveViewOverrides?: ActiveViewOverrides,\n\tdefaultView?: View\n): View {\n\tif ( ! activeViewOverrides ) {\n\t\treturn view;\n\t}\n\n\tlet result = view;\n\n\t// Merge filters\n\tif (\n\t\tactiveViewOverrides.filters &&\n\t\tactiveViewOverrides.filters.length > 0\n\t) {\n\t\tconst activeFields = new Set(\n\t\t\tactiveViewOverrides.filters.map( ( f ) => f.field )\n\t\t);\n\t\tconst preserved = ( view.filters ?? [] ).filter(\n\t\t\t( f: Filter ) => ! activeFields.has( f.field )\n\t\t);\n\t\tresult = {\n\t\t\t...result,\n\t\t\tfilters: [ ...preserved, ...activeViewOverrides.filters ],\n\t\t};\n\t}\n\n\t// Merge sort - only apply if the current sort matches the default\n\tif ( activeViewOverrides.sort ) {\n\t\tconst isDefaultSort =\n\t\t\tdefaultView &&\n\t\t\tview.sort?.field === defaultView.sort?.field &&\n\t\t\tview.sort?.direction === defaultView.sort?.direction;\n\n\t\tif ( isDefaultSort ) {\n\t\t\tresult = {\n\t\t\t\t...result,\n\t\t\t\tsort: activeViewOverrides.sort,\n\t\t\t};\n\t\t}\n\t}\n\n\treturn result;\n}\n\n/**\n * Strips overrides before persisting.\n * Filters: Removes filters on fields managed by activeViewOverrides.\n * Sort: If sort matches the override, restores the default sort.\n *\n * @param view                The view to strip overrides from.\n * @param activeViewOverrides The tab-specific override definitions.\n * @param defaultView         The default view configuration.\n * @return A new view with overrides stripped, or the original view if no overrides.\n */\nexport function stripActiveViewOverrides(\n\tview: View,\n\tactiveViewOverrides?: ActiveViewOverrides,\n\tdefaultView?: View\n): View {\n\tif ( ! activeViewOverrides ) {\n\t\treturn view;\n\t}\n\n\tlet result = view;\n\n\t// Strip managed filters\n\tif (\n\t\tactiveViewOverrides.filters &&\n\t\tactiveViewOverrides.filters.length > 0\n\t) {\n\t\tconst activeFields = new Set(\n\t\t\tactiveViewOverrides.filters.map( ( f ) => f.field )\n\t\t);\n\t\tresult = {\n\t\t\t...result,\n\t\t\tfilters: ( view.filters ?? [] ).filter(\n\t\t\t\t( f: Filter ) => ! activeFields.has( f.field )\n\t\t\t),\n\t\t};\n\t}\n\n\t// Strip sort if it matches the override (restore to default)\n\tif (\n\t\tactiveViewOverrides.sort &&\n\t\tview.sort?.field === activeViewOverrides.sort.field &&\n\t\tview.sort?.direction === activeViewOverrides.sort.direction\n\t) {\n\t\tresult = {\n\t\t\t...result,\n\t\t\tsort: defaultView?.sort,\n\t\t};\n\t}\n\n\treturn result;\n}\n"],
+  "mappings": ";AAoBO,SAAS,yBACf,MACA,qBACA,aACO;AACP,MAAK,CAAE,qBAAsB;AAC5B,WAAO;AAAA,EACR;AAEA,MAAI,SAAS;AAGb,MACC,oBAAoB,WACpB,oBAAoB,QAAQ,SAAS,GACpC;AACD,UAAM,eAAe,IAAI;AAAA,MACxB,oBAAoB,QAAQ,IAAK,CAAE,MAAO,EAAE,KAAM;AAAA,IACnD;AACA,UAAM,aAAc,KAAK,WAAW,CAAC,GAAI;AAAA,MACxC,CAAE,MAAe,CAAE,aAAa,IAAK,EAAE,KAAM;AAAA,IAC9C;AACA,aAAS;AAAA,MACR,GAAG;AAAA,MACH,SAAS,CAAE,GAAG,WAAW,GAAG,oBAAoB,OAAQ;AAAA,IACzD;AAAA,EACD;AAGA,MAAK,oBAAoB,MAAO;AAC/B,UAAM,gBACL,eACA,KAAK,MAAM,UAAU,YAAY,MAAM,SACvC,KAAK,MAAM,cAAc,YAAY,MAAM;AAE5C,QAAK,eAAgB;AACpB,eAAS;AAAA,QACR,GAAG;AAAA,QACH,MAAM,oBAAoB;AAAA,MAC3B;AAAA,IACD;AAAA,EACD;AAEA,SAAO;AACR;AAYO,SAAS,yBACf,MACA,qBACA,aACO;AACP,MAAK,CAAE,qBAAsB;AAC5B,WAAO;AAAA,EACR;AAEA,MAAI,SAAS;AAGb,MACC,oBAAoB,WACpB,oBAAoB,QAAQ,SAAS,GACpC;AACD,UAAM,eAAe,IAAI;AAAA,MACxB,oBAAoB,QAAQ,IAAK,CAAE,MAAO,EAAE,KAAM;AAAA,IACnD;AACA,aAAS;AAAA,MACR,GAAG;AAAA,MACH,UAAW,KAAK,WAAW,CAAC,GAAI;AAAA,QAC/B,CAAE,MAAe,CAAE,aAAa,IAAK,EAAE,KAAM;AAAA,MAC9C;AAAA,IACD;AAAA,EACD;AAGA,MACC,oBAAoB,QACpB,KAAK,MAAM,UAAU,oBAAoB,KAAK,SAC9C,KAAK,MAAM,cAAc,oBAAoB,KAAK,WACjD;AACD,aAAS;AAAA,MACR,GAAG;AAAA,MACH,MAAM,aAAa;AAAA,IACpB;AAAA,EACD;AAEA,SAAO;AACR;",
+  "names": []
+}

package/build-module/load-view.mjs

@@ -2,8 +2,9 @@
 import { select } from "@wordpress/data";
 import { store as preferencesStore } from "@wordpress/preferences";
 import { generatePreferenceKey } from "./preference-keys.mjs";
+import { mergeActiveViewOverrides } from "./filter-utils.mjs";
 async function loadView(config) {
-  const { kind, name, slug, defaultView, queryParams } = config;
+  const { kind, name, slug, defaultView, activeViewOverrides, queryParams } = config;
   const preferenceKey = generatePreferenceKey(kind, name, slug);
   const persistedView = select(preferencesStore).get(
     "core/views",
@@ -12,11 +13,15 @@ async function loadView(config) {
   const baseView = persistedView ?? defaultView;
   const page = queryParams?.page ?? 1;
   const search = queryParams?.search ?? "";
-  return {
-    ...baseView,
-    page,
-    search
-  };
+  return mergeActiveViewOverrides(
+    {
+      ...baseView,
+      page,
+      search
+    },
+    activeViewOverrides,
+    defaultView
+  );
 }
 export {
   loadView

package/build-module/load-view.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/load-view.ts"],
-  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { select } from '@wordpress/data';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\nimport type { View } from '@wordpress/dataviews';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport type { ViewConfig } from './types';\n\n/**\n * Async function for loading view state in route loaders with optional URL parameters.\n *\n * @example\n *\n * ```typescript\n * // In route loader\n * const view = await loadView( {\n * \tkind: 'taxonomy',\n * \tname: 'category',\n * \tslug: 'all',\n * \tdefaultView,\n * \tqueryParams: { page: search.page, search: search.search },\n * } );\n * ```\n *\n * @param config             Configuration object for loading the view.\n * @param config.kind        Entity kind (e.g., 'postType', 'taxonomy', 'root').\n * @param config.name        Specific entity name.\n * @param config.slug        View identifier.\n * @param config.defaultView Default view configuration.\n * @param config.queryParams Object with `page` and/or `search` from URL.\n *\n * @return Promise resolving to the loaded view object.\n */\nexport async function loadView( config: ViewConfig ) {\n\tconst { kind, name, slug, defaultView, queryParams } = config;\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = select( preferencesStore ).get(\n\t\t'core/views',\n\t\tpreferenceKey\n\t) as View | undefined;\n\n\tconst baseView = persistedView ?? defaultView;\n\tconst page = queryParams?.page ?? 1;\n\tconst search = queryParams?.search ?? '';\n\n\treturn {\n\t\t...baseView,\n\t\tpage,\n\t\tsearch,\n\t};\n}\n"],
-  "mappings": ";AAGA,SAAS,cAAc;AAEvB,SAAS,SAAS,wBAAwB;AAM1C,SAAS,6BAA6B;AA4BtC,eAAsB,SAAU,QAAqB;AACpD,QAAM,EAAE,MAAM,MAAM,MAAM,aAAa,YAAY,IAAI;AACvD,QAAM,gBAAgB,sBAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,gBAAkC,OAAQ,gBAAiB,EAAE;AAAA,IAClE;AAAA,IACA;AAAA,EACD;AAEA,QAAM,WAAW,iBAAiB;AAClC,QAAM,OAAO,aAAa,QAAQ;AAClC,QAAM,SAAS,aAAa,UAAU;AAEtC,SAAO;AAAA,IACN,GAAG;AAAA,IACH;AAAA,IACA;AAAA,EACD;AACD;",
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport { select } from '@wordpress/data';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\nimport type { View } from '@wordpress/dataviews';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport { mergeActiveViewOverrides } from './filter-utils';\nimport type { ViewConfig } from './types';\n\n/**\n * Async function for loading view state in route loaders.\n *\n * @param config                     Configuration object for loading the view.\n * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').\n * @param config.name                Specific entity name.\n * @param config.slug                View identifier.\n * @param config.defaultView         Default view configuration.\n * @param config.activeViewOverrides View overrides applied on top but never persisted.\n * @param config.queryParams         Object with `page` and/or `search` from URL.\n * @return Promise resolving to the loaded view object.\n */\nexport async function loadView( config: ViewConfig ) {\n\tconst { kind, name, slug, defaultView, activeViewOverrides, queryParams } =\n\t\tconfig;\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = select( preferencesStore ).get(\n\t\t'core/views',\n\t\tpreferenceKey\n\t) as View | undefined;\n\n\tconst baseView = persistedView ?? defaultView;\n\tconst page = queryParams?.page ?? 1;\n\tconst search = queryParams?.search ?? '';\n\n\treturn mergeActiveViewOverrides(\n\t\t{\n\t\t\t...baseView,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t},\n\t\tactiveViewOverrides,\n\t\tdefaultView\n\t);\n}\n"],
+  "mappings": ";AAGA,SAAS,cAAc;AAEvB,SAAS,SAAS,wBAAwB;AAM1C,SAAS,6BAA6B;AACtC,SAAS,gCAAgC;AAezC,eAAsB,SAAU,QAAqB;AACpD,QAAM,EAAE,MAAM,MAAM,MAAM,aAAa,qBAAqB,YAAY,IACvE;AACD,QAAM,gBAAgB,sBAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,gBAAkC,OAAQ,gBAAiB,EAAE;AAAA,IAClE;AAAA,IACA;AAAA,EACD;AAEA,QAAM,WAAW,iBAAiB;AAClC,QAAM,OAAO,aAAa,QAAQ;AAClC,QAAM,SAAS,aAAa,UAAU;AAEtC,SAAO;AAAA,IACN;AAAA,MACC,GAAG;AAAA,MACH;AAAA,MACA;AAAA,IACD;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;",
   "names": []
 }

package/build-module/use-view.mjs

@@ -1,9 +1,13 @@
 // packages/views/src/use-view.ts
 import { dequal } from "dequal";
-import { generatePreferenceKey } from "./preference-keys.mjs";
 import { useCallback, useMemo } from "@wordpress/element";
 import { useDispatch, useSelect } from "@wordpress/data";
 import { store as preferencesStore } from "@wordpress/preferences";
+import { generatePreferenceKey } from "./preference-keys.mjs";
+import {
+  mergeActiveViewOverrides,
+  stripActiveViewOverrides
+} from "./filter-utils.mjs";
 function omit(obj, keys) {
   const result = { ...obj };
   for (const key of keys) {
@@ -12,7 +16,15 @@ function omit(obj, keys) {
   return result;
 }
 function useView(config) {
-  const { kind, name, slug, defaultView, queryParams, onChangeQueryParams } = config;
+  const {
+    kind,
+    name,
+    slug,
+    defaultView,
+    activeViewOverrides,
+    queryParams,
+    onChangeQueryParams
+  } = config;
   const preferenceKey = generatePreferenceKey(kind, name, slug);
   const persistedView = useSelect(
     (select) => {
@@ -28,12 +40,16 @@ function useView(config) {
   const page = Number(queryParams?.page ?? baseView.page ?? 1);
   const search = queryParams?.search ?? baseView.search ?? "";
   const view = useMemo(() => {
-    return {
-      ...baseView,
-      page,
-      search
-    };
-  }, [baseView, page, search]);
+    return mergeActiveViewOverrides(
+      {
+        ...baseView,
+        page,
+        search
+      },
+      activeViewOverrides,
+      defaultView
+    );
+  }, [baseView, page, search, activeViewOverrides, defaultView]);
   const isModified = !!persistedView;
   const updateView = useCallback(
     (newView) => {
@@ -41,12 +57,26 @@ function useView(config) {
         page: newView?.page,
         search: newView?.search
       };
-      const preferenceView = omit(newView, ["page", "search"]);
+      const preferenceView = stripActiveViewOverrides(
+        omit(newView, ["page", "search"]),
+        activeViewOverrides,
+        defaultView
+      );
       if (onChangeQueryParams && !dequal(urlParams, { page, search })) {
         onChangeQueryParams(urlParams);
       }
-      if (!dequal(baseView, preferenceView)) {
-        if (dequal(preferenceView, defaultView)) {
+      const comparableBaseView = stripActiveViewOverrides(
+        baseView,
+        activeViewOverrides,
+        defaultView
+      );
+      const comparableDefaultView = stripActiveViewOverrides(
+        defaultView,
+        activeViewOverrides,
+        defaultView
+      );
+      if (!dequal(comparableBaseView, preferenceView)) {
+        if (dequal(preferenceView, comparableDefaultView)) {
           set("core/views", preferenceKey, void 0);
         } else {
           set("core/views", preferenceKey, preferenceView);
@@ -59,6 +89,7 @@ function useView(config) {
       search,
       baseView,
       defaultView,
+      activeViewOverrides,
       set,
       preferenceKey
     ]

package/build-module/use-view.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/use-view.ts"],
-  "sourcesContent": ["/**\n * External dependencies\n */\nimport { dequal } from 'dequal';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport type { ViewConfig } from './types';\n\n/**\n * WordPress dependencies\n */\nimport { useCallback, useMemo } from '@wordpress/element';\nimport { useDispatch, useSelect } from '@wordpress/data';\nimport type { View } from '@wordpress/dataviews';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\n\ninterface UseViewReturn {\n\tview: View;\n\tisModified: boolean;\n\tupdateView: ( newView: View ) => void;\n\tresetToDefault: () => void;\n}\n\nfunction omit< T extends object, K extends keyof T >(\n\tobj: T,\n\tkeys: K[]\n): Omit< T, K > {\n\tconst result = { ...obj };\n\tfor ( const key of keys ) {\n\t\tdelete result[ key ];\n\t}\n\treturn result;\n}\n\n/**\n * Hook for managing DataViews view state with local persistence.\n *\n * @param config                     Configuration object for loading the view.\n * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').\n * @param config.name                Specific entity name.\n * @param config.slug                View identifier.\n * @param config.defaultView         Default view configuration.\n * @param config.queryParams         Object with `page` and/or `search` from URL.\n * @param config.onChangeQueryParams Optional callback to update URL parameters.\n *\n * @return Object with current view, modification state, and update functions.\n */\nexport function useView( config: ViewConfig ): UseViewReturn {\n\tconst { kind, name, slug, defaultView, queryParams, onChangeQueryParams } =\n\t\tconfig;\n\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = useSelect(\n\t\t( select ) => {\n\t\t\treturn select( preferencesStore ).get(\n\t\t\t\t'core/views',\n\t\t\t\tpreferenceKey\n\t\t\t) as View | undefined;\n\t\t},\n\t\t[ preferenceKey ]\n\t);\n\tconst { set } = useDispatch( preferencesStore );\n\n\tconst baseView: View = persistedView ?? defaultView;\n\tconst page = Number( queryParams?.page ?? baseView.page ?? 1 );\n\tconst search = queryParams?.search ?? baseView.search ?? '';\n\n\t// Merge URL query parameters (page, search) into the view\n\tconst view: View = useMemo( () => {\n\t\treturn {\n\t\t\t...baseView,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t};\n\t}, [ baseView, page, search ] );\n\n\tconst isModified = !! persistedView;\n\n\tconst updateView = useCallback(\n\t\t( newView: View ) => {\n\t\t\t// Extract URL params (page, search) from the new view\n\t\t\tconst urlParams: { page?: number; search?: string } = {\n\t\t\t\tpage: newView?.page,\n\t\t\t\tsearch: newView?.search,\n\t\t\t};\n\t\t\tconst preferenceView = omit( newView, [ 'page', 'search' ] );\n\n\t\t\t// If we have URL handling enabled, separate URL state from preference state\n\t\t\tif (\n\t\t\t\tonChangeQueryParams &&\n\t\t\t\t! dequal( urlParams, { page, search } )\n\t\t\t) {\n\t\t\t\tonChangeQueryParams( urlParams );\n\t\t\t}\n\n\t\t\t// Only persist non-URL preferences if different from baseView\n\t\t\tif ( ! dequal( baseView, preferenceView ) ) {\n\t\t\t\tif ( dequal( preferenceView, defaultView ) ) {\n\t\t\t\t\tset( 'core/views', preferenceKey, undefined );\n\t\t\t\t} else {\n\t\t\t\t\tset( 'core/views', preferenceKey, preferenceView );\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t[\n\t\t\tonChangeQueryParams,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t\tbaseView,\n\t\t\tdefaultView,\n\t\t\tset,\n\t\t\tpreferenceKey,\n\t\t]\n\t);\n\n\tconst resetToDefault = useCallback( () => {\n\t\tset( 'core/views', preferenceKey, undefined );\n\t}, [ preferenceKey, set ] );\n\n\treturn {\n\t\tview,\n\t\tisModified,\n\t\tupdateView,\n\t\tresetToDefault,\n\t};\n}\n"],
-  "mappings": ";AAGA,SAAS,cAAc;AAKvB,SAAS,6BAA6B;AAMtC,SAAS,aAAa,eAAe;AACrC,SAAS,aAAa,iBAAiB;AAGvC,SAAS,SAAS,wBAAwB;AAS1C,SAAS,KACR,KACA,MACe;AACf,QAAM,SAAS,EAAE,GAAG,IAAI;AACxB,aAAY,OAAO,MAAO;AACzB,WAAO,OAAQ,GAAI;AAAA,EACpB;AACA,SAAO;AACR;AAeO,SAAS,QAAS,QAAoC;AAC5D,QAAM,EAAE,MAAM,MAAM,MAAM,aAAa,aAAa,oBAAoB,IACvE;AAED,QAAM,gBAAgB,sBAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,gBAAkC;AAAA,IACvC,CAAE,WAAY;AACb,aAAO,OAAQ,gBAAiB,EAAE;AAAA,QACjC;AAAA,QACA;AAAA,MACD;AAAA,IACD;AAAA,IACA,CAAE,aAAc;AAAA,EACjB;AACA,QAAM,EAAE,IAAI,IAAI,YAAa,gBAAiB;AAE9C,QAAM,WAAiB,iBAAiB;AACxC,QAAM,OAAO,OAAQ,aAAa,QAAQ,SAAS,QAAQ,CAAE;AAC7D,QAAM,SAAS,aAAa,UAAU,SAAS,UAAU;AAGzD,QAAM,OAAa,QAAS,MAAM;AACjC,WAAO;AAAA,MACN,GAAG;AAAA,MACH;AAAA,MACA;AAAA,IACD;AAAA,EACD,GAAG,CAAE,UAAU,MAAM,MAAO,CAAE;AAE9B,QAAM,aAAa,CAAC,CAAE;AAEtB,QAAM,aAAa;AAAA,IAClB,CAAE,YAAmB;AAEpB,YAAM,YAAgD;AAAA,QACrD,MAAM,SAAS;AAAA,QACf,QAAQ,SAAS;AAAA,MAClB;AACA,YAAM,iBAAiB,KAAM,SAAS,CAAE,QAAQ,QAAS,CAAE;AAG3D,UACC,uBACA,CAAE,OAAQ,WAAW,EAAE,MAAM,OAAO,CAAE,GACrC;AACD,4BAAqB,SAAU;AAAA,MAChC;AAGA,UAAK,CAAE,OAAQ,UAAU,cAAe,GAAI;AAC3C,YAAK,OAAQ,gBAAgB,WAAY,GAAI;AAC5C,cAAK,cAAc,eAAe,MAAU;AAAA,QAC7C,OAAO;AACN,cAAK,cAAc,eAAe,cAAe;AAAA,QAClD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD;AAEA,QAAM,iBAAiB,YAAa,MAAM;AACzC,QAAK,cAAc,eAAe,MAAU;AAAA,EAC7C,GAAG,CAAE,eAAe,GAAI,CAAE;AAE1B,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;",
+  "sourcesContent": ["/**\n * External dependencies\n */\nimport { dequal } from 'dequal';\n\n/**\n * WordPress dependencies\n */\nimport { useCallback, useMemo } from '@wordpress/element';\nimport { useDispatch, useSelect } from '@wordpress/data';\nimport type { View } from '@wordpress/dataviews';\n// @ts-ignore - Preferences package is not typed\nimport { store as preferencesStore } from '@wordpress/preferences';\n\n/**\n * Internal dependencies\n */\nimport { generatePreferenceKey } from './preference-keys';\nimport {\n\tmergeActiveViewOverrides,\n\tstripActiveViewOverrides,\n} from './filter-utils';\nimport type { ViewConfig } from './types';\n\ninterface UseViewReturn {\n\tview: View;\n\tisModified: boolean;\n\tupdateView: ( newView: View ) => void;\n\tresetToDefault: () => void;\n}\n\nfunction omit< T extends object, K extends keyof T >(\n\tobj: T,\n\tkeys: K[]\n): Omit< T, K > {\n\tconst result = { ...obj };\n\tfor ( const key of keys ) {\n\t\tdelete result[ key ];\n\t}\n\treturn result;\n}\n\n/**\n * Hook for managing DataViews view state with local persistence.\n *\n * @param config Configuration object for loading the view.\n *\n * @return Object with current view, modification state, and update functions.\n */\nexport function useView( config: ViewConfig ): UseViewReturn {\n\tconst {\n\t\tkind,\n\t\tname,\n\t\tslug,\n\t\tdefaultView,\n\t\tactiveViewOverrides,\n\t\tqueryParams,\n\t\tonChangeQueryParams,\n\t} = config;\n\n\tconst preferenceKey = generatePreferenceKey( kind, name, slug );\n\tconst persistedView: View | undefined = useSelect(\n\t\t( select ) => {\n\t\t\treturn select( preferencesStore ).get(\n\t\t\t\t'core/views',\n\t\t\t\tpreferenceKey\n\t\t\t) as View | undefined;\n\t\t},\n\t\t[ preferenceKey ]\n\t);\n\tconst { set } = useDispatch( preferencesStore );\n\n\tconst baseView: View = persistedView ?? defaultView;\n\tconst page = Number( queryParams?.page ?? baseView.page ?? 1 );\n\tconst search = queryParams?.search ?? baseView.search ?? '';\n\n\t// Merge URL query parameters (page, search) and activeViewOverrides into the view\n\tconst view: View = useMemo( () => {\n\t\treturn mergeActiveViewOverrides(\n\t\t\t{\n\t\t\t\t...baseView,\n\t\t\t\tpage,\n\t\t\t\tsearch,\n\t\t\t},\n\t\t\tactiveViewOverrides,\n\t\t\tdefaultView\n\t\t);\n\t}, [ baseView, page, search, activeViewOverrides, defaultView ] );\n\n\tconst isModified = !! persistedView;\n\n\tconst updateView = useCallback(\n\t\t( newView: View ) => {\n\t\t\t// Extract URL params (page, search) from the new view\n\t\t\tconst urlParams: { page?: number; search?: string } = {\n\t\t\t\tpage: newView?.page,\n\t\t\t\tsearch: newView?.search,\n\t\t\t};\n\t\t\t// Strip activeViewOverrides and URL params before persisting\n\t\t\t// Cast is safe: omitting page/search doesn't change the discriminant (type field)\n\t\t\tconst preferenceView = stripActiveViewOverrides(\n\t\t\t\tomit( newView, [ 'page', 'search' ] ) as View,\n\t\t\t\tactiveViewOverrides,\n\t\t\t\tdefaultView\n\t\t\t);\n\n\t\t\t// If we have URL handling enabled, separate URL state from preference state\n\t\t\tif (\n\t\t\t\tonChangeQueryParams &&\n\t\t\t\t! dequal( urlParams, { page, search } )\n\t\t\t) {\n\t\t\t\tonChangeQueryParams( urlParams );\n\t\t\t}\n\n\t\t\t// Compare with baseView and defaultView after stripping activeViewOverrides\n\t\t\tconst comparableBaseView = stripActiveViewOverrides(\n\t\t\t\tbaseView,\n\t\t\t\tactiveViewOverrides,\n\t\t\t\tdefaultView\n\t\t\t);\n\t\t\tconst comparableDefaultView = stripActiveViewOverrides(\n\t\t\t\tdefaultView,\n\t\t\t\tactiveViewOverrides,\n\t\t\t\tdefaultView\n\t\t\t);\n\n\t\t\t// Only persist non-URL preferences if different from baseView\n\t\t\tif ( ! dequal( comparableBaseView, preferenceView ) ) {\n\t\t\t\tif ( dequal( preferenceView, comparableDefaultView ) ) {\n\t\t\t\t\tset( 'core/views', preferenceKey, undefined );\n\t\t\t\t} else {\n\t\t\t\t\tset( 'core/views', preferenceKey, preferenceView );\n\t\t\t\t}\n\t\t\t}\n\t\t},\n\t\t[\n\t\t\tonChangeQueryParams,\n\t\t\tpage,\n\t\t\tsearch,\n\t\t\tbaseView,\n\t\t\tdefaultView,\n\t\t\tactiveViewOverrides,\n\t\t\tset,\n\t\t\tpreferenceKey,\n\t\t]\n\t);\n\n\tconst resetToDefault = useCallback( () => {\n\t\tset( 'core/views', preferenceKey, undefined );\n\t}, [ preferenceKey, set ] );\n\n\treturn {\n\t\tview,\n\t\tisModified,\n\t\tupdateView,\n\t\tresetToDefault,\n\t};\n}\n"],
+  "mappings": ";AAGA,SAAS,cAAc;AAKvB,SAAS,aAAa,eAAe;AACrC,SAAS,aAAa,iBAAiB;AAGvC,SAAS,SAAS,wBAAwB;AAK1C,SAAS,6BAA6B;AACtC;AAAA,EACC;AAAA,EACA;AAAA,OACM;AAUP,SAAS,KACR,KACA,MACe;AACf,QAAM,SAAS,EAAE,GAAG,IAAI;AACxB,aAAY,OAAO,MAAO;AACzB,WAAO,OAAQ,GAAI;AAAA,EACpB;AACA,SAAO;AACR;AASO,SAAS,QAAS,QAAoC;AAC5D,QAAM;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD,IAAI;AAEJ,QAAM,gBAAgB,sBAAuB,MAAM,MAAM,IAAK;AAC9D,QAAM,gBAAkC;AAAA,IACvC,CAAE,WAAY;AACb,aAAO,OAAQ,gBAAiB,EAAE;AAAA,QACjC;AAAA,QACA;AAAA,MACD;AAAA,IACD;AAAA,IACA,CAAE,aAAc;AAAA,EACjB;AACA,QAAM,EAAE,IAAI,IAAI,YAAa,gBAAiB;AAE9C,QAAM,WAAiB,iBAAiB;AACxC,QAAM,OAAO,OAAQ,aAAa,QAAQ,SAAS,QAAQ,CAAE;AAC7D,QAAM,SAAS,aAAa,UAAU,SAAS,UAAU;AAGzD,QAAM,OAAa,QAAS,MAAM;AACjC,WAAO;AAAA,MACN;AAAA,QACC,GAAG;AAAA,QACH;AAAA,QACA;AAAA,MACD;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD,GAAG,CAAE,UAAU,MAAM,QAAQ,qBAAqB,WAAY,CAAE;AAEhE,QAAM,aAAa,CAAC,CAAE;AAEtB,QAAM,aAAa;AAAA,IAClB,CAAE,YAAmB;AAEpB,YAAM,YAAgD;AAAA,QACrD,MAAM,SAAS;AAAA,QACf,QAAQ,SAAS;AAAA,MAClB;AAGA,YAAM,iBAAiB;AAAA,QACtB,KAAM,SAAS,CAAE,QAAQ,QAAS,CAAE;AAAA,QACpC;AAAA,QACA;AAAA,MACD;AAGA,UACC,uBACA,CAAE,OAAQ,WAAW,EAAE,MAAM,OAAO,CAAE,GACrC;AACD,4BAAqB,SAAU;AAAA,MAChC;AAGA,YAAM,qBAAqB;AAAA,QAC1B;AAAA,QACA;AAAA,QACA;AAAA,MACD;AACA,YAAM,wBAAwB;AAAA,QAC7B;AAAA,QACA;AAAA,QACA;AAAA,MACD;AAGA,UAAK,CAAE,OAAQ,oBAAoB,cAAe,GAAI;AACrD,YAAK,OAAQ,gBAAgB,qBAAsB,GAAI;AACtD,cAAK,cAAc,eAAe,MAAU;AAAA,QAC7C,OAAO;AACN,cAAK,cAAc,eAAe,cAAe;AAAA,QAClD;AAAA,MACD;AAAA,IACD;AAAA,IACA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACD;AAAA,EACD;AAEA,QAAM,iBAAiB,YAAa,MAAM;AACzC,QAAK,cAAc,eAAe,MAAU;AAAA,EAC7C,GAAG,CAAE,eAAe,GAAI,CAAE;AAE1B,SAAO;AAAA,IACN;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACD;AACD;",
   "names": []
 }

package/build-types/filter-utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * WordPress dependencies
+ */
+import type { View, Filter } from '@wordpress/dataviews';
+type ActiveViewOverrides = {
+    filters?: Filter[];
+    sort?: View['sort'];
+};
+/**
+ * Merges activeViewOverrides into a view.
+ * Filters: Active filters take precedence; same-field filters are replaced.
+ * Sort: Active sort is applied only if current sort matches the default.
+ *
+ * @param view                The view to merge overrides into.
+ * @param activeViewOverrides The tab-specific overrides to apply.
+ * @param defaultView         The default view configuration.
+ * @return A new view with merged overrides, or the original view if no overrides.
+ */
+export declare function mergeActiveViewOverrides(view: View, activeViewOverrides?: ActiveViewOverrides, defaultView?: View): View;
+/**
+ * Strips overrides before persisting.
+ * Filters: Removes filters on fields managed by activeViewOverrides.
+ * Sort: If sort matches the override, restores the default sort.
+ *
+ * @param view                The view to strip overrides from.
+ * @param activeViewOverrides The tab-specific override definitions.
+ * @param defaultView         The default view configuration.
+ * @return A new view with overrides stripped, or the original view if no overrides.
+ */
+export declare function stripActiveViewOverrides(view: View, activeViewOverrides?: ActiveViewOverrides, defaultView?: View): View;
+export {};
+//# sourceMappingURL=filter-utils.d.ts.map

package/build-types/filter-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-utils.d.ts","sourceRoot":"","sources":["../src/filter-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEzD,KAAK,mBAAmB,GAAG;IAC1B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAE,MAAM,CAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,IAAI,EACV,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,WAAW,CAAC,EAAE,IAAI,GAChB,IAAI,CAwCN;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,IAAI,EACV,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,WAAW,CAAC,EAAE,IAAI,GAChB,IAAI,CAoCN"}

package/build-types/load-view.d.ts

@@ -1,196 +1,16 @@
+import type { View } from '@wordpress/dataviews';
 import type { ViewConfig } from './types';
 /**
- * Async function for loading view state in route loaders with optional URL parameters.
- *
- * @example
- *
- * ```typescript
- * // In route loader
- * const view = await loadView( {
- * 	kind: 'taxonomy',
- * 	name: 'category',
- * 	slug: 'all',
- * 	defaultView,
- * 	queryParams: { page: search.page, search: search.search },
- * } );
- * ```
- *
- * @param config             Configuration object for loading the view.
- * @param config.kind        Entity kind (e.g., 'postType', 'taxonomy', 'root').
- * @param config.name        Specific entity name.
- * @param config.slug        View identifier.
- * @param config.defaultView Default view configuration.
- * @param config.queryParams Object with `page` and/or `search` from URL.
+ * Async function for loading view state in route loaders.
  *
+ * @param config                     Configuration object for loading the view.
+ * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').
+ * @param config.name                Specific entity name.
+ * @param config.slug                View identifier.
+ * @param config.defaultView         Default view configuration.
+ * @param config.activeViewOverrides View overrides applied on top but never persisted.
+ * @param config.queryParams         Object with `page` and/or `search` from URL.
  * @return Promise resolving to the loaded view object.
  */
-export declare function loadView(config: ViewConfig): Promise<{
-    page: number;
-    search: string;
-    type: "list";
-    layout?: {
-        density?: import("@wordpress/dataviews").Density;
-    };
-    filters?: import("@wordpress/dataviews").Filter[];
-    sort?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-    };
-    perPage?: number;
-    fields?: string[];
-    titleField?: string;
-    mediaField?: string;
-    descriptionField?: string;
-    showTitle?: boolean;
-    showMedia?: boolean;
-    showDescription?: boolean;
-    showLevels?: boolean;
-    groupBy?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-        showLabel?: boolean;
-    };
-    infiniteScrollEnabled?: boolean;
-} | {
-    page: number;
-    search: string;
-    type: "grid";
-    layout?: {
-        badgeFields?: string[];
-        previewSize?: number;
-    };
-    filters?: import("@wordpress/dataviews").Filter[];
-    sort?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-    };
-    perPage?: number;
-    fields?: string[];
-    titleField?: string;
-    mediaField?: string;
-    descriptionField?: string;
-    showTitle?: boolean;
-    showMedia?: boolean;
-    showDescription?: boolean;
-    showLevels?: boolean;
-    groupBy?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-        showLabel?: boolean;
-    };
-    infiniteScrollEnabled?: boolean;
-} | {
-    page: number;
-    search: string;
-    type: "table";
-    layout?: {
-        styles?: Record<string, import("@wordpress/dataviews").ColumnStyle>;
-        density?: import("@wordpress/dataviews").Density;
-        enableMoving?: boolean;
-    };
-    filters?: import("@wordpress/dataviews").Filter[];
-    sort?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-    };
-    perPage?: number;
-    fields?: string[];
-    titleField?: string;
-    mediaField?: string;
-    descriptionField?: string;
-    showTitle?: boolean;
-    showMedia?: boolean;
-    showDescription?: boolean;
-    showLevels?: boolean;
-    groupBy?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-        showLabel?: boolean;
-    };
-    infiniteScrollEnabled?: boolean;
-} | {
-    page: number;
-    search: string;
-    type: "pickerGrid";
-    layout?: {
-        badgeFields?: string[];
-        previewSize?: number;
-    };
-    filters?: import("@wordpress/dataviews").Filter[];
-    sort?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-    };
-    perPage?: number;
-    fields?: string[];
-    titleField?: string;
-    mediaField?: string;
-    descriptionField?: string;
-    showTitle?: boolean;
-    showMedia?: boolean;
-    showDescription?: boolean;
-    showLevels?: boolean;
-    groupBy?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-        showLabel?: boolean;
-    };
-    infiniteScrollEnabled?: boolean;
-} | {
-    page: number;
-    search: string;
-    type: "pickerTable";
-    layout?: {
-        styles?: Record<string, import("@wordpress/dataviews").ColumnStyle>;
-        density?: import("@wordpress/dataviews").Density;
-        enableMoving?: boolean;
-    };
-    filters?: import("@wordpress/dataviews").Filter[];
-    sort?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-    };
-    perPage?: number;
-    fields?: string[];
-    titleField?: string;
-    mediaField?: string;
-    descriptionField?: string;
-    showTitle?: boolean;
-    showMedia?: boolean;
-    showDescription?: boolean;
-    showLevels?: boolean;
-    groupBy?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-        showLabel?: boolean;
-    };
-    infiniteScrollEnabled?: boolean;
-} | {
-    page: number;
-    search: string;
-    type: "activity";
-    layout?: {
-        density?: import("@wordpress/dataviews").Density;
-    };
-    filters?: import("@wordpress/dataviews").Filter[];
-    sort?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-    };
-    perPage?: number;
-    fields?: string[];
-    titleField?: string;
-    mediaField?: string;
-    descriptionField?: string;
-    showTitle?: boolean;
-    showMedia?: boolean;
-    showDescription?: boolean;
-    showLevels?: boolean;
-    groupBy?: {
-        field: string;
-        direction: import("@wordpress/dataviews").SortDirection;
-        showLabel?: boolean;
-    };
-    infiniteScrollEnabled?: boolean;
-}>;
+export declare function loadView(config: ViewConfig): Promise<View>;
 //# sourceMappingURL=load-view.d.ts.map

package/build-types/load-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-view.d.ts","sourceRoot":"","sources":["../src/load-view.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,QAAQ,CAAE,MAAM,EAAE,UAAU;;;;;eAkB0jF,CAAC;;;;;;;;;;;;;;;;;;;iBAAxnC,CAAC;;;;;;;;mBAAw+C,CAAC;mBAAgG,CAAC;;;;;;;;;;;;;;;;;;;iBAA3kD,CAAC;;;;;;;;cAAmvB,CAAC;eAA0G,CAAC;oBAAyG,CAAC;;;;;;;;;;;;;;;;;;;iBAA18B,CAAC;;;;;;;;mBAAgxD,CAAC;mBAAgG,CAAC;;;;;;;;;;;;;;;;;;;iBAAn3D,CAAC;;;;;;;;cAA8iE,CAAC;eAA0G,CAAC;oBAAyG,CAAC;;;;;;;;;;;;;;;;;;;iBAArwE,CAAC;;;;;;;;eAA4yC,CAAC;;;;;;;;;;;;;;;;;;;iBAA9yC,CAAC;;;GADr/C"}
+{"version":3,"file":"load-view.d.ts","sourceRoot":"","sources":["../src/load-view.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAOjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAE,MAAM,EAAE,UAAU,iBAsBjD"}

package/build-types/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * WordPress dependencies
  */
-import type { View } from '@wordpress/dataviews';
+import type { View, Filter } from '@wordpress/dataviews';
 export interface ViewConfig {
     /**
      * Entity kind (e.g. postType, root).
@@ -21,6 +21,15 @@ export interface ViewConfig {
      * Default view configuration
      */
     defaultView: View;
+    /**
+     * View overrides applied on top of the persisted view but never persisted.
+     * These represent tab-specific configuration (filters, sort) that should
+     * override the persisted view settings.
+     */
+    activeViewOverrides?: {
+        filters?: Filter[];
+        sort?: View['sort'];
+    };
     /**
      * Optional query parameters from URL (page, search)
      */

package/build-types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAE,MAAM,EAAE;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,KAAM,IAAI,CAAC;CACZ"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEzD,MAAM,WAAW,UAAU;IAC1B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,IAAI,CAAC;IAElB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE;QACrB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,IAAI,CAAE,MAAM,CAAE,CAAC;KACtB,CAAC;IAEF;;OAEG;IACH,WAAW,CAAC,EAAE;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,mBAAmB,CAAC,EAAE,CAAE,MAAM,EAAE;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;KAChB,KAAM,IAAI,CAAC;CACZ"}

package/build-types/use-view.d.ts

@@ -1,5 +1,5 @@
-import type { ViewConfig } from './types';
 import type { View } from '@wordpress/dataviews';
+import type { ViewConfig } from './types';
 interface UseViewReturn {
     view: View;
     isModified: boolean;
@@ -9,13 +9,7 @@ interface UseViewReturn {
 /**
  * Hook for managing DataViews view state with local persistence.
  *
- * @param config                     Configuration object for loading the view.
- * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').
- * @param config.name                Specific entity name.
- * @param config.slug                View identifier.
- * @param config.defaultView         Default view configuration.
- * @param config.queryParams         Object with `page` and/or `search` from URL.
- * @param config.onChangeQueryParams Optional callback to update URL parameters.
+ * @param config Configuration object for loading the view.
  *
  * @return Object with current view, modification state, and update functions.
  */

package/build-types/use-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-view.d.ts","sourceRoot":"","sources":["../src/use-view.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAO1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,UAAU,aAAa;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,CAAE,OAAO,EAAE,IAAI,KAAM,IAAI,CAAC;IACtC,cAAc,EAAE,MAAM,IAAI,CAAC;CAC3B;AAaD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAE,MAAM,EAAE,UAAU,GAAI,aAAa,CA8E3D"}
+{"version":3,"file":"use-view.d.ts","sourceRoot":"","sources":["../src/use-view.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAYjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,UAAU,aAAa;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,CAAE,OAAO,EAAE,IAAI,KAAM,IAAI,CAAC;IACtC,cAAc,EAAE,MAAM,IAAI,CAAC;CAC3B;AAaD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAE,MAAM,EAAE,UAAU,GAAI,aAAa,CA4G3D"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/views",
-	"version": "1.6.0",
+	"version": "1.6.1-next.v.20260206T143.0+81f8de885",
 	"description": "View persistence and management for WordPress DataViews.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -41,14 +41,14 @@
 	},
 	"types": "build-types",
 	"dependencies": {
-		"@wordpress/data": "^10.39.0",
-		"@wordpress/dataviews": "^11.3.0",
-		"@wordpress/element": "^6.39.0",
-		"@wordpress/preferences": "^4.39.0",
+		"@wordpress/data": "^10.39.1-next.v.20260206T143.0+81f8de885",
+		"@wordpress/dataviews": "^12.0.1-next.v.20260206T143.0+81f8de885",
+		"@wordpress/element": "^6.39.1-next.v.20260206T143.0+81f8de885",
+		"@wordpress/preferences": "^4.39.1-next.v.20260206T143.0+81f8de885",
 		"dequal": "^2.0.3"
 	},
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "eee1cfb1472f11183e40fb77465a5f13145df7ad"
+	"gitHead": "6ae3fbb907e6c309ff6a0685e5e5ff0c2ee23b15"
 }

package/src/filter-utils.ts

@@ -0,0 +1,117 @@
+/**
+ * WordPress dependencies
+ */
+import type { View, Filter } from '@wordpress/dataviews';
+
+type ActiveViewOverrides = {
+	filters?: Filter[];
+	sort?: View[ 'sort' ];
+};
+
+/**
+ * Merges activeViewOverrides into a view.
+ * Filters: Active filters take precedence; same-field filters are replaced.
+ * Sort: Active sort is applied only if current sort matches the default.
+ *
+ * @param view                The view to merge overrides into.
+ * @param activeViewOverrides The tab-specific overrides to apply.
+ * @param defaultView         The default view configuration.
+ * @return A new view with merged overrides, or the original view if no overrides.
+ */
+export function mergeActiveViewOverrides(
+	view: View,
+	activeViewOverrides?: ActiveViewOverrides,
+	defaultView?: View
+): View {
+	if ( ! activeViewOverrides ) {
+		return view;
+	}
+
+	let result = view;
+
+	// Merge filters
+	if (
+		activeViewOverrides.filters &&
+		activeViewOverrides.filters.length > 0
+	) {
+		const activeFields = new Set(
+			activeViewOverrides.filters.map( ( f ) => f.field )
+		);
+		const preserved = ( view.filters ?? [] ).filter(
+			( f: Filter ) => ! activeFields.has( f.field )
+		);
+		result = {
+			...result,
+			filters: [ ...preserved, ...activeViewOverrides.filters ],
+		};
+	}
+
+	// Merge sort - only apply if the current sort matches the default
+	if ( activeViewOverrides.sort ) {
+		const isDefaultSort =
+			defaultView &&
+			view.sort?.field === defaultView.sort?.field &&
+			view.sort?.direction === defaultView.sort?.direction;
+
+		if ( isDefaultSort ) {
+			result = {
+				...result,
+				sort: activeViewOverrides.sort,
+			};
+		}
+	}
+
+	return result;
+}
+
+/**
+ * Strips overrides before persisting.
+ * Filters: Removes filters on fields managed by activeViewOverrides.
+ * Sort: If sort matches the override, restores the default sort.
+ *
+ * @param view                The view to strip overrides from.
+ * @param activeViewOverrides The tab-specific override definitions.
+ * @param defaultView         The default view configuration.
+ * @return A new view with overrides stripped, or the original view if no overrides.
+ */
+export function stripActiveViewOverrides(
+	view: View,
+	activeViewOverrides?: ActiveViewOverrides,
+	defaultView?: View
+): View {
+	if ( ! activeViewOverrides ) {
+		return view;
+	}
+
+	let result = view;
+
+	// Strip managed filters
+	if (
+		activeViewOverrides.filters &&
+		activeViewOverrides.filters.length > 0
+	) {
+		const activeFields = new Set(
+			activeViewOverrides.filters.map( ( f ) => f.field )
+		);
+		result = {
+			...result,
+			filters: ( view.filters ?? [] ).filter(
+				( f: Filter ) => ! activeFields.has( f.field )
+			),
+		};
+	}
+
+	// Strip sort if it matches the override (restore to default)
+	if (
+		activeViewOverrides.sort &&
+		view.sort?.field === activeViewOverrides.sort.field &&
+		view.sort?.direction === activeViewOverrides.sort.direction
+	) {
+		result = {
+			...result,
+			sort: defaultView?.sort,
+		};
+	}
+
+	return result;
+}

package/src/load-view.ts

@@ -10,35 +10,24 @@ import type { View } from '@wordpress/dataviews';
  * Internal dependencies
  */
 import { generatePreferenceKey } from './preference-keys';
+import { mergeActiveViewOverrides } from './filter-utils';
 import type { ViewConfig } from './types';
 
 /**
- * Async function for loading view state in route loaders with optional URL parameters.
- *
- * @example
- *
- * ```typescript
- * // In route loader
- * const view = await loadView( {
- * 	kind: 'taxonomy',
- * 	name: 'category',
- * 	slug: 'all',
- * 	defaultView,
- * 	queryParams: { page: search.page, search: search.search },
- * } );
- * ```
- *
- * @param config             Configuration object for loading the view.
- * @param config.kind        Entity kind (e.g., 'postType', 'taxonomy', 'root').
- * @param config.name        Specific entity name.
- * @param config.slug        View identifier.
- * @param config.defaultView Default view configuration.
- * @param config.queryParams Object with `page` and/or `search` from URL.
+ * Async function for loading view state in route loaders.
  *
+ * @param config                     Configuration object for loading the view.
+ * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').
+ * @param config.name                Specific entity name.
+ * @param config.slug                View identifier.
+ * @param config.defaultView         Default view configuration.
+ * @param config.activeViewOverrides View overrides applied on top but never persisted.
+ * @param config.queryParams         Object with `page` and/or `search` from URL.
  * @return Promise resolving to the loaded view object.
  */
 export async function loadView( config: ViewConfig ) {
-	const { kind, name, slug, defaultView, queryParams } = config;
+	const { kind, name, slug, defaultView, activeViewOverrides, queryParams } =
+		config;
 	const preferenceKey = generatePreferenceKey( kind, name, slug );
 	const persistedView: View | undefined = select( preferencesStore ).get(
 		'core/views',
@@ -49,9 +38,13 @@ export async function loadView( config: ViewConfig ) {
 	const page = queryParams?.page ?? 1;
 	const search = queryParams?.search ?? '';
 
-	return {
-		...baseView,
-		page,
-		search,
-	};
+	return mergeActiveViewOverrides(
+		{
+			...baseView,
+			page,
+			search,
+		},
+		activeViewOverrides,
+		defaultView
+	);
 }

package/src/types.ts

@@ -1,7 +1,7 @@
 /**
  * WordPress dependencies
  */
-import type { View } from '@wordpress/dataviews';
+import type { View, Filter } from '@wordpress/dataviews';
 
 export interface ViewConfig {
 	/**
@@ -26,6 +26,16 @@ export interface ViewConfig {
 	 */
 	defaultView: View;
 
+	/**
+	 * View overrides applied on top of the persisted view but never persisted.
+	 * These represent tab-specific configuration (filters, sort) that should
+	 * override the persisted view settings.
+	 */
+	activeViewOverrides?: {
+		filters?: Filter[];
+		sort?: View[ 'sort' ];
+	};
+
 	/**
 	 * Optional query parameters from URL (page, search)
 	 */

package/src/use-view.ts

@@ -3,12 +3,6 @@
  */
 import { dequal } from 'dequal';
 
-/**
- * Internal dependencies
- */
-import { generatePreferenceKey } from './preference-keys';
-import type { ViewConfig } from './types';
-
 /**
  * WordPress dependencies
  */
@@ -18,6 +12,16 @@ import type { View } from '@wordpress/dataviews';
 // @ts-ignore - Preferences package is not typed
 import { store as preferencesStore } from '@wordpress/preferences';
 
+/**
+ * Internal dependencies
+ */
+import { generatePreferenceKey } from './preference-keys';
+import {
+	mergeActiveViewOverrides,
+	stripActiveViewOverrides,
+} from './filter-utils';
+import type { ViewConfig } from './types';
+
 interface UseViewReturn {
 	view: View;
 	isModified: boolean;
@@ -39,19 +43,20 @@ function omit< T extends object, K extends keyof T >(
 /**
  * Hook for managing DataViews view state with local persistence.
  *
- * @param config                     Configuration object for loading the view.
- * @param config.kind                Entity kind (e.g., 'postType', 'taxonomy', 'root').
- * @param config.name                Specific entity name.
- * @param config.slug                View identifier.
- * @param config.defaultView         Default view configuration.
- * @param config.queryParams         Object with `page` and/or `search` from URL.
- * @param config.onChangeQueryParams Optional callback to update URL parameters.
+ * @param config Configuration object for loading the view.
  *
  * @return Object with current view, modification state, and update functions.
  */
 export function useView( config: ViewConfig ): UseViewReturn {
-	const { kind, name, slug, defaultView, queryParams, onChangeQueryParams } =
-		config;
+	const {
+		kind,
+		name,
+		slug,
+		defaultView,
+		activeViewOverrides,
+		queryParams,
+		onChangeQueryParams,
+	} = config;
 
 	const preferenceKey = generatePreferenceKey( kind, name, slug );
 	const persistedView: View | undefined = useSelect(
@@ -69,14 +74,18 @@ export function useView( config: ViewConfig ): UseViewReturn {
 	const page = Number( queryParams?.page ?? baseView.page ?? 1 );
 	const search = queryParams?.search ?? baseView.search ?? '';
 
-	// Merge URL query parameters (page, search) into the view
+	// Merge URL query parameters (page, search) and activeViewOverrides into the view
 	const view: View = useMemo( () => {
-		return {
-			...baseView,
-			page,
-			search,
-		};
-	}, [ baseView, page, search ] );
+		return mergeActiveViewOverrides(
+			{
+				...baseView,
+				page,
+				search,
+			},
+			activeViewOverrides,
+			defaultView
+		);
+	}, [ baseView, page, search, activeViewOverrides, defaultView ] );
 
 	const isModified = !! persistedView;
 
@@ -87,7 +96,13 @@ export function useView( config: ViewConfig ): UseViewReturn {
 				page: newView?.page,
 				search: newView?.search,
 			};
-			const preferenceView = omit( newView, [ 'page', 'search' ] );
+			// Strip activeViewOverrides and URL params before persisting
+			// Cast is safe: omitting page/search doesn't change the discriminant (type field)
+			const preferenceView = stripActiveViewOverrides(
+				omit( newView, [ 'page', 'search' ] ) as View,
+				activeViewOverrides,
+				defaultView
+			);
 
 			// If we have URL handling enabled, separate URL state from preference state
 			if (
@@ -97,9 +112,21 @@ export function useView( config: ViewConfig ): UseViewReturn {
 				onChangeQueryParams( urlParams );
 			}
 
+			// Compare with baseView and defaultView after stripping activeViewOverrides
+			const comparableBaseView = stripActiveViewOverrides(
+				baseView,
+				activeViewOverrides,
+				defaultView
+			);
+			const comparableDefaultView = stripActiveViewOverrides(
+				defaultView,
+				activeViewOverrides,
+				defaultView
+			);
+
 			// Only persist non-URL preferences if different from baseView
-			if ( ! dequal( baseView, preferenceView ) ) {
-				if ( dequal( preferenceView, defaultView ) ) {
+			if ( ! dequal( comparableBaseView, preferenceView ) ) {
+				if ( dequal( preferenceView, comparableDefaultView ) ) {
 					set( 'core/views', preferenceKey, undefined );
 				} else {
 					set( 'core/views', preferenceKey, preferenceView );
@@ -112,6 +139,7 @@ export function useView( config: ViewConfig ): UseViewReturn {
 			search,
 			baseView,
 			defaultView,
+			activeViewOverrides,
 			set,
 			preferenceKey,
 		]