@wordpress/views 1.7.1-next.v.202602241322.0 → 1.8.0

package/build/filter-utils.cjs

@@ -24,11 +24,26 @@ __export(filter_utils_exports, {
   stripActiveViewOverrides: () => stripActiveViewOverrides
 });
 module.exports = __toCommonJS(filter_utils_exports);
+var SCALAR_VALUES = [
+  "titleField",
+  "mediaField",
+  "descriptionField",
+  "showTitle",
+  "showMedia",
+  "showDescription",
+  "showLevels",
+  "infiniteScrollEnabled"
+];
 function mergeActiveViewOverrides(view, activeViewOverrides, defaultView) {
   if (!activeViewOverrides) {
     return view;
   }
   let result = view;
+  for (const key of SCALAR_VALUES) {
+    if (key in activeViewOverrides) {
+      result = { ...result, [key]: activeViewOverrides[key] };
+    }
+  }
   if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
     const activeFields = new Set(
       activeViewOverrides.filters.map((f) => f.field)
@@ -50,6 +65,21 @@ function mergeActiveViewOverrides(view, activeViewOverrides, defaultView) {
       };
     }
   }
+  if (activeViewOverrides.layout) {
+    result = {
+      ...result,
+      layout: {
+        ...result.layout,
+        ...activeViewOverrides.layout
+      }
+    };
+  }
+  if (activeViewOverrides.groupBy) {
+    result = {
+      ...result,
+      groupBy: activeViewOverrides.groupBy
+    };
+  }
   return result;
 }
 function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
@@ -57,6 +87,12 @@ function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
     return view;
   }
   let result = view;
+  for (const key of SCALAR_VALUES) {
+    if (key in activeViewOverrides) {
+      const { [key]: _, ...rest } = result;
+      result = rest;
+    }
+  }
   if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
     const activeFields = new Set(
       activeViewOverrides.filters.map((f) => f.field)
@@ -74,6 +110,20 @@ function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
       sort: defaultView?.sort
     };
   }
+  if (activeViewOverrides.layout && "layout" in result && result.layout) {
+    const layout = { ...result.layout };
+    for (const key of Object.keys(activeViewOverrides.layout)) {
+      delete layout[key];
+    }
+    result = {
+      ...result,
+      layout: Object.keys(layout).length > 0 ? layout : void 0
+    };
+  }
+  if (activeViewOverrides.groupBy && "groupBy" in result) {
+    const { groupBy: _, ...rest } = result;
+    result = rest;
+  }
   return result;
 }
 // Annotate the CommonJS export names for ESM import in node:

package/build/filter-utils.cjs.map

@@ -1,7 +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;",
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport type { View, Filter } from '@wordpress/dataviews';\n\n/**\n * Internal dependencies\n */\nimport type { ActiveViewOverrides } from './types';\n\nconst SCALAR_VALUES = [\n\t'titleField',\n\t'mediaField',\n\t'descriptionField',\n\t'showTitle',\n\t'showMedia',\n\t'showDescription',\n\t'showLevels',\n\t'infiniteScrollEnabled',\n] as const;\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 scalar overrides \u2014 always win over persisted values\n\tfor ( const key of SCALAR_VALUES ) {\n\t\tif ( key in activeViewOverrides ) {\n\t\t\tresult = { ...result, [ key ]: activeViewOverrides[ key ] };\n\t\t}\n\t}\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\t// Merge layout \u2014 shallow merge, override keys always win\n\tif ( activeViewOverrides.layout ) {\n\t\tresult = {\n\t\t\t...result,\n\t\t\tlayout: {\n\t\t\t\t...( result as any ).layout,\n\t\t\t\t...activeViewOverrides.layout,\n\t\t\t},\n\t\t} as View;\n\t}\n\n\t// Merge groupBy \u2014 full replacement, override always wins\n\tif ( activeViewOverrides.groupBy ) {\n\t\tresult = {\n\t\t\t...result,\n\t\t\tgroupBy: activeViewOverrides.groupBy,\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 scalar keys managed by overrides\n\tfor ( const key of SCALAR_VALUES ) {\n\t\tif ( key in activeViewOverrides ) {\n\t\t\tconst { [ key ]: _, ...rest } = result;\n\t\t\tresult = rest as View;\n\t\t}\n\t}\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\t// Strip layout keys managed by overrides\n\tif ( activeViewOverrides.layout && 'layout' in result && result.layout ) {\n\t\tconst layout = { ...result.layout } as Record< string, unknown >;\n\t\tfor ( const key of Object.keys( activeViewOverrides.layout ) ) {\n\t\t\tdelete layout[ key ];\n\t\t}\n\t\tresult = {\n\t\t\t...result,\n\t\t\tlayout: Object.keys( layout ).length > 0 ? layout : undefined,\n\t\t} as View;\n\t}\n\n\t// Strip groupBy managed by overrides\n\tif ( activeViewOverrides.groupBy && 'groupBy' in result ) {\n\t\tconst { groupBy: _, ...rest } = result;\n\t\tresult = rest as View;\n\t}\n\n\treturn result;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/types.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/types.ts"],
-  "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"],
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport type { View } from '@wordpress/dataviews';\n\nexport type ActiveViewOverrides = {\n\t// scalar values\n\ttitleField?: View[ 'titleField' ];\n\tshowTitle?: View[ 'showTitle' ];\n\tmediaField?: View[ 'mediaField' ];\n\tshowMedia?: View[ 'showMedia' ];\n\tdescriptionField?: View[ 'descriptionField' ];\n\tshowDescription?: View[ 'showDescription' ];\n\tshowLevels?: View[ 'showLevels' ];\n\tinfiniteScrollEnabled?: View[ 'infiniteScrollEnabled' ];\n\t// array & object values\n\tfilters?: View[ 'filters' ];\n\tsort?: View[ 'sort' ];\n\tgroupBy?: View[ 'groupBy' ];\n\tlayout?: Record< string, unknown >;\n};\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) and\n\t * developer-defined view defaults that should override the persisted\n\t * view settings.\n\t */\n\tactiveViewOverrides?: ActiveViewOverrides;\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-module/filter-utils.mjs

@@ -1,9 +1,24 @@
 // packages/views/src/filter-utils.ts
+var SCALAR_VALUES = [
+  "titleField",
+  "mediaField",
+  "descriptionField",
+  "showTitle",
+  "showMedia",
+  "showDescription",
+  "showLevels",
+  "infiniteScrollEnabled"
+];
 function mergeActiveViewOverrides(view, activeViewOverrides, defaultView) {
   if (!activeViewOverrides) {
     return view;
   }
   let result = view;
+  for (const key of SCALAR_VALUES) {
+    if (key in activeViewOverrides) {
+      result = { ...result, [key]: activeViewOverrides[key] };
+    }
+  }
   if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
     const activeFields = new Set(
       activeViewOverrides.filters.map((f) => f.field)
@@ -25,6 +40,21 @@ function mergeActiveViewOverrides(view, activeViewOverrides, defaultView) {
       };
     }
   }
+  if (activeViewOverrides.layout) {
+    result = {
+      ...result,
+      layout: {
+        ...result.layout,
+        ...activeViewOverrides.layout
+      }
+    };
+  }
+  if (activeViewOverrides.groupBy) {
+    result = {
+      ...result,
+      groupBy: activeViewOverrides.groupBy
+    };
+  }
   return result;
 }
 function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
@@ -32,6 +62,12 @@ function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
     return view;
   }
   let result = view;
+  for (const key of SCALAR_VALUES) {
+    if (key in activeViewOverrides) {
+      const { [key]: _, ...rest } = result;
+      result = rest;
+    }
+  }
   if (activeViewOverrides.filters && activeViewOverrides.filters.length > 0) {
     const activeFields = new Set(
       activeViewOverrides.filters.map((f) => f.field)
@@ -49,6 +85,20 @@ function stripActiveViewOverrides(view, activeViewOverrides, defaultView) {
       sort: defaultView?.sort
     };
   }
+  if (activeViewOverrides.layout && "layout" in result && result.layout) {
+    const layout = { ...result.layout };
+    for (const key of Object.keys(activeViewOverrides.layout)) {
+      delete layout[key];
+    }
+    result = {
+      ...result,
+      layout: Object.keys(layout).length > 0 ? layout : void 0
+    };
+  }
+  if (activeViewOverrides.groupBy && "groupBy" in result) {
+    const { groupBy: _, ...rest } = result;
+    result = rest;
+  }
   return result;
 }
 export {

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

@@ -1,7 +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;",
+  "sourcesContent": ["/**\n * WordPress dependencies\n */\nimport type { View, Filter } from '@wordpress/dataviews';\n\n/**\n * Internal dependencies\n */\nimport type { ActiveViewOverrides } from './types';\n\nconst SCALAR_VALUES = [\n\t'titleField',\n\t'mediaField',\n\t'descriptionField',\n\t'showTitle',\n\t'showMedia',\n\t'showDescription',\n\t'showLevels',\n\t'infiniteScrollEnabled',\n] as const;\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 scalar overrides \u2014 always win over persisted values\n\tfor ( const key of SCALAR_VALUES ) {\n\t\tif ( key in activeViewOverrides ) {\n\t\t\tresult = { ...result, [ key ]: activeViewOverrides[ key ] };\n\t\t}\n\t}\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\t// Merge layout \u2014 shallow merge, override keys always win\n\tif ( activeViewOverrides.layout ) {\n\t\tresult = {\n\t\t\t...result,\n\t\t\tlayout: {\n\t\t\t\t...( result as any ).layout,\n\t\t\t\t...activeViewOverrides.layout,\n\t\t\t},\n\t\t} as View;\n\t}\n\n\t// Merge groupBy \u2014 full replacement, override always wins\n\tif ( activeViewOverrides.groupBy ) {\n\t\tresult = {\n\t\t\t...result,\n\t\t\tgroupBy: activeViewOverrides.groupBy,\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 scalar keys managed by overrides\n\tfor ( const key of SCALAR_VALUES ) {\n\t\tif ( key in activeViewOverrides ) {\n\t\t\tconst { [ key ]: _, ...rest } = result;\n\t\t\tresult = rest as View;\n\t\t}\n\t}\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\t// Strip layout keys managed by overrides\n\tif ( activeViewOverrides.layout && 'layout' in result && result.layout ) {\n\t\tconst layout = { ...result.layout } as Record< string, unknown >;\n\t\tfor ( const key of Object.keys( activeViewOverrides.layout ) ) {\n\t\t\tdelete layout[ key ];\n\t\t}\n\t\tresult = {\n\t\t\t...result,\n\t\t\tlayout: Object.keys( layout ).length > 0 ? layout : undefined,\n\t\t} as View;\n\t}\n\n\t// Strip groupBy managed by overrides\n\tif ( activeViewOverrides.groupBy && 'groupBy' in result ) {\n\t\tconst { groupBy: _, ...rest } = result;\n\t\tresult = rest as View;\n\t}\n\n\treturn result;\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -1,11 +1,11 @@
 /**
  * WordPress dependencies
  */
-import type { View, Filter } from '@wordpress/dataviews';
-type ActiveViewOverrides = {
-    filters?: Filter[];
-    sort?: View['sort'];
-};
+import type { View } from '@wordpress/dataviews';
+/**
+ * Internal dependencies
+ */
+import type { ActiveViewOverrides } from './types';
 /**
  * Merges activeViewOverrides into a view.
  * Filters: Active filters take precedence; same-field filters are replaced.
@@ -28,5 +28,4 @@ export declare function mergeActiveViewOverrides(view: View, activeViewOverrides
  * @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

@@ -1 +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"}
+{"version":3,"file":"filter-utils.d.ts","sourceRoot":"","sources":["../src/filter-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAU,MAAM,sBAAsB,CAAC;AAEzD;;GAEG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAanD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,IAAI,EACV,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,WAAW,CAAC,EAAE,IAAI,GAChB,IAAI,CAkEN;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,IAAI,EACV,mBAAmB,CAAC,EAAE,mBAAmB,EACzC,WAAW,CAAC,EAAE,IAAI,GAChB,IAAI,CA8DN"}

package/build-types/types.d.ts

@@ -1,7 +1,21 @@
 /**
  * WordPress dependencies
  */
-import type { View, Filter } from '@wordpress/dataviews';
+import type { View } from '@wordpress/dataviews';
+export type ActiveViewOverrides = {
+    titleField?: View['titleField'];
+    showTitle?: View['showTitle'];
+    mediaField?: View['mediaField'];
+    showMedia?: View['showMedia'];
+    descriptionField?: View['descriptionField'];
+    showDescription?: View['showDescription'];
+    showLevels?: View['showLevels'];
+    infiniteScrollEnabled?: View['infiniteScrollEnabled'];
+    filters?: View['filters'];
+    sort?: View['sort'];
+    groupBy?: View['groupBy'];
+    layout?: Record<string, unknown>;
+};
 export interface ViewConfig {
     /**
      * Entity kind (e.g. postType, root).
@@ -23,13 +37,11 @@ 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.
+     * These represent tab-specific configuration (filters, sort) and
+     * developer-defined view defaults that should override the persisted
+     * view settings.
      */
-    activeViewOverrides?: {
-        filters?: Filter[];
-        sort?: View['sort'];
-    };
+    activeViewOverrides?: ActiveViewOverrides;
     /**
      * 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,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"}
+{"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,MAAM,mBAAmB,GAAG;IAEjC,UAAU,CAAC,EAAE,IAAI,CAAE,YAAY,CAAE,CAAC;IAClC,SAAS,CAAC,EAAE,IAAI,CAAE,WAAW,CAAE,CAAC;IAChC,UAAU,CAAC,EAAE,IAAI,CAAE,YAAY,CAAE,CAAC;IAClC,SAAS,CAAC,EAAE,IAAI,CAAE,WAAW,CAAE,CAAC;IAChC,gBAAgB,CAAC,EAAE,IAAI,CAAE,kBAAkB,CAAE,CAAC;IAC9C,eAAe,CAAC,EAAE,IAAI,CAAE,iBAAiB,CAAE,CAAC;IAC5C,UAAU,CAAC,EAAE,IAAI,CAAE,YAAY,CAAE,CAAC;IAClC,qBAAqB,CAAC,EAAE,IAAI,CAAE,uBAAuB,CAAE,CAAC;IAExD,OAAO,CAAC,EAAE,IAAI,CAAE,SAAS,CAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,IAAI,CAAE,MAAM,CAAE,CAAC;IACtB,OAAO,CAAC,EAAE,IAAI,CAAE,SAAS,CAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,CAAC;CACnC,CAAC;AAEF,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;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAE1C;;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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/views",
-	"version": "1.7.1-next.v.202602241322.0+bce7cff88",
+	"version": "1.8.0",
 	"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.40.1-next.v.202602241322.0+bce7cff88",
-		"@wordpress/dataviews": "^12.1.1-next.v.202602241322.0+bce7cff88",
-		"@wordpress/element": "^6.40.1-next.v.202602241322.0+bce7cff88",
-		"@wordpress/preferences": "^4.40.1-next.v.202602241322.0+bce7cff88",
+		"@wordpress/data": "^10.41.0",
+		"@wordpress/dataviews": "^13.0.0",
+		"@wordpress/element": "^6.41.0",
+		"@wordpress/preferences": "^4.41.0",
 		"dequal": "^2.0.3"
 	},
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "943dde7f0b600ce238726c36284bc9f70ce0ffa4"
+	"gitHead": "8bfc179b9aed74c0a6dd6e8edf7a49e40e4f87cc"
 }

package/src/filter-utils.ts

@@ -3,10 +3,21 @@
  */
 import type { View, Filter } from '@wordpress/dataviews';
 
-type ActiveViewOverrides = {
-	filters?: Filter[];
-	sort?: View[ 'sort' ];
-};
+/**
+ * Internal dependencies
+ */
+import type { ActiveViewOverrides } from './types';
+
+const SCALAR_VALUES = [
+	'titleField',
+	'mediaField',
+	'descriptionField',
+	'showTitle',
+	'showMedia',
+	'showDescription',
+	'showLevels',
+	'infiniteScrollEnabled',
+] as const;
 
 /**
  * Merges activeViewOverrides into a view.
@@ -29,6 +40,13 @@ export function mergeActiveViewOverrides(
 
 	let result = view;
 
+	// Merge scalar overrides — always win over persisted values
+	for ( const key of SCALAR_VALUES ) {
+		if ( key in activeViewOverrides ) {
+			result = { ...result, [ key ]: activeViewOverrides[ key ] };
+		}
+	}
+
 	// Merge filters
 	if (
 		activeViewOverrides.filters &&
@@ -61,6 +79,25 @@ export function mergeActiveViewOverrides(
 		}
 	}
 
+	// Merge layout — shallow merge, override keys always win
+	if ( activeViewOverrides.layout ) {
+		result = {
+			...result,
+			layout: {
+				...( result as any ).layout,
+				...activeViewOverrides.layout,
+			},
+		} as View;
+	}
+
+	// Merge groupBy — full replacement, override always wins
+	if ( activeViewOverrides.groupBy ) {
+		result = {
+			...result,
+			groupBy: activeViewOverrides.groupBy,
+		};
+	}
+
 	return result;
 }
 
@@ -85,6 +122,14 @@ export function stripActiveViewOverrides(
 
 	let result = view;
 
+	// Strip scalar keys managed by overrides
+	for ( const key of SCALAR_VALUES ) {
+		if ( key in activeViewOverrides ) {
+			const { [ key ]: _, ...rest } = result;
+			result = rest as View;
+		}
+	}
+
 	// Strip managed filters
 	if (
 		activeViewOverrides.filters &&
@@ -113,5 +158,23 @@ export function stripActiveViewOverrides(
 		};
 	}
 
+	// Strip layout keys managed by overrides
+	if ( activeViewOverrides.layout && 'layout' in result && result.layout ) {
+		const layout = { ...result.layout } as Record< string, unknown >;
+		for ( const key of Object.keys( activeViewOverrides.layout ) ) {
+			delete layout[ key ];
+		}
+		result = {
+			...result,
+			layout: Object.keys( layout ).length > 0 ? layout : undefined,
+		} as View;
+	}
+
+	// Strip groupBy managed by overrides
+	if ( activeViewOverrides.groupBy && 'groupBy' in result ) {
+		const { groupBy: _, ...rest } = result;
+		result = rest as View;
+	}
+
 	return result;
 }

package/src/test/filter-utils.ts

@@ -0,0 +1,522 @@
+/**
+ * WordPress dependencies
+ */
+import type { View } from '@wordpress/dataviews';
+
+/**
+ * Internal dependencies
+ */
+import {
+	mergeActiveViewOverrides,
+	stripActiveViewOverrides,
+} from '../filter-utils';
+
+const baseView: View = {
+	type: 'table',
+	filters: [ { field: 'author', operator: 'isAny', value: [ 'admin' ] } ],
+	sort: { field: 'date', direction: 'desc' },
+	page: 1,
+	perPage: 25,
+};
+
+const defaultView: View = {
+	type: 'table',
+	sort: { field: 'date', direction: 'desc' },
+};
+
+describe( 'mergeActiveViewOverrides', () => {
+	it( 'should return the view unchanged when no overrides are provided', () => {
+		expect( mergeActiveViewOverrides( baseView ) ).toBe( baseView );
+		expect( mergeActiveViewOverrides( baseView, undefined ) ).toBe(
+			baseView
+		);
+	} );
+
+	describe( 'scalar overrides', () => {
+		it( 'should merge titleField override', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				titleField: 'name',
+			} );
+			expect( result.titleField ).toBe( 'name' );
+		} );
+
+		it( 'should merge mediaField override', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				mediaField: 'thumbnail',
+			} );
+			expect( result.mediaField ).toBe( 'thumbnail' );
+		} );
+
+		it( 'should merge descriptionField override', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				descriptionField: 'excerpt',
+			} );
+			expect( result.descriptionField ).toBe( 'excerpt' );
+		} );
+
+		it( 'should merge showTitle override', () => {
+			const result = mergeActiveViewOverrides(
+				{ ...baseView, showTitle: true },
+				{ showTitle: false }
+			);
+			expect( result.showTitle ).toBe( false );
+		} );
+
+		it( 'should merge showMedia override', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				showMedia: true,
+			} );
+			expect( result.showMedia ).toBe( true );
+		} );
+
+		it( 'should merge showDescription override', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				showDescription: false,
+			} );
+			expect( result.showDescription ).toBe( false );
+		} );
+
+		it( 'should merge showLevels override', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				showLevels: true,
+			} );
+			expect( result.showLevels ).toBe( true );
+		} );
+
+		it( 'should merge infiniteScrollEnabled override', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				infiniteScrollEnabled: true,
+			} );
+			expect( result.infiniteScrollEnabled ).toBe( true );
+		} );
+
+		it( 'should override existing scalar value on the view', () => {
+			const view: View = { ...baseView, titleField: 'old-title' };
+			const result = mergeActiveViewOverrides( view, {
+				titleField: 'new-title',
+			} );
+			expect( result.titleField ).toBe( 'new-title' );
+		} );
+
+		it( 'should merge multiple scalar overrides at once', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				titleField: 'name',
+				showTitle: true,
+				showMedia: false,
+				infiniteScrollEnabled: true,
+			} );
+			expect( result.titleField ).toBe( 'name' );
+			expect( result.showTitle ).toBe( true );
+			expect( result.showMedia ).toBe( false );
+			expect( result.infiniteScrollEnabled ).toBe( true );
+		} );
+	} );
+
+	describe( 'filter overrides', () => {
+		it( 'should add override filters', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				filters: [
+					{ field: 'status', operator: 'isAny', value: 'publish' },
+				],
+			} );
+			expect( result.filters ).toHaveLength( 2 );
+			expect( result.filters ).toEqual(
+				expect.arrayContaining( [
+					{ field: 'author', operator: 'isAny', value: [ 'admin' ] },
+					{
+						field: 'status',
+						operator: 'isAny',
+						value: 'publish',
+					},
+				] )
+			);
+		} );
+
+		it( 'should replace same-field filters', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				filters: [
+					{
+						field: 'author',
+						operator: 'isAny',
+						value: [ 'editor' ],
+					},
+				],
+			} );
+			expect( result.filters ).toHaveLength( 1 );
+			expect( result.filters![ 0 ] ).toEqual( {
+				field: 'author',
+				operator: 'isAny',
+				value: [ 'editor' ],
+			} );
+		} );
+
+		it( 'should handle empty override filters array', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				filters: [],
+			} );
+			// Empty filters array is treated as no override.
+			expect( result.filters ).toEqual( baseView.filters );
+		} );
+	} );
+
+	describe( 'sort overrides', () => {
+		it( 'should apply sort override when current sort matches default', () => {
+			const result = mergeActiveViewOverrides(
+				baseView,
+				{ sort: { field: 'title', direction: 'asc' } },
+				defaultView
+			);
+			expect( result.sort ).toEqual( {
+				field: 'title',
+				direction: 'asc',
+			} );
+		} );
+
+		it( 'should not apply sort override when user has changed sort', () => {
+			const userView: View = {
+				...baseView,
+				sort: { field: 'title', direction: 'asc' },
+			};
+			const result = mergeActiveViewOverrides(
+				userView,
+				{ sort: { field: 'modified', direction: 'desc' } },
+				defaultView
+			);
+			expect( result.sort ).toEqual( {
+				field: 'title',
+				direction: 'asc',
+			} );
+		} );
+
+		it( 'should not apply sort override when no default view is provided', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				sort: { field: 'title', direction: 'asc' },
+			} );
+			expect( result.sort ).toEqual( baseView.sort );
+		} );
+	} );
+
+	describe( 'layout overrides', () => {
+		it( 'should merge layout override into existing layout', () => {
+			const view: View = {
+				...baseView,
+				layout: { density: 'compact' },
+			};
+			const result = mergeActiveViewOverrides( view, {
+				layout: { styles: { author: { align: 'end' } } },
+			} );
+			expect( result.layout ).toEqual( {
+				density: 'compact',
+				styles: { author: { align: 'end' } },
+			} );
+		} );
+
+		it( 'should set layout when view has no existing layout', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				layout: { styles: { title: { width: '50%' } } },
+			} );
+			expect( result.layout ).toEqual( {
+				styles: { title: { width: '50%' } },
+			} );
+		} );
+
+		it( 'should override matching layout keys', () => {
+			const view: View = {
+				...baseView,
+				layout: {
+					density: 'compact',
+					styles: { old: { width: '10%' } },
+				},
+			};
+			const result = mergeActiveViewOverrides( view, {
+				layout: { styles: { new: { width: '20%' } } },
+			} );
+			// Shallow merge: styles key is replaced entirely.
+			expect( result.layout ).toEqual( {
+				density: 'compact',
+				styles: { new: { width: '20%' } },
+			} );
+		} );
+	} );
+
+	describe( 'groupBy overrides', () => {
+		it( 'should replace groupBy with override', () => {
+			const view: View = {
+				...baseView,
+				groupBy: {
+					field: 'status',
+					direction: 'asc',
+					showLabel: false,
+				},
+			};
+			const result = mergeActiveViewOverrides( view, {
+				groupBy: { field: 'category', direction: 'desc' },
+			} );
+			expect( result.groupBy ).toEqual( {
+				field: 'category',
+				direction: 'desc',
+			} );
+		} );
+
+		it( 'should set groupBy when view has none', () => {
+			const result = mergeActiveViewOverrides( baseView, {
+				groupBy: { field: 'category', direction: 'desc' },
+			} );
+			expect( result.groupBy ).toEqual( {
+				field: 'category',
+				direction: 'desc',
+			} );
+		} );
+	} );
+
+	it( 'should not mutate the original view', () => {
+		const original = { ...baseView };
+		mergeActiveViewOverrides( original, {
+			titleField: 'name',
+			filters: [
+				{ field: 'status', operator: 'isAny', value: 'publish' },
+			],
+			layout: { styles: {} },
+		} );
+		expect( original ).toEqual( baseView );
+	} );
+} );
+
+describe( 'stripActiveViewOverrides', () => {
+	it( 'should return the view unchanged when no overrides are provided', () => {
+		expect( stripActiveViewOverrides( baseView ) ).toBe( baseView );
+		expect( stripActiveViewOverrides( baseView, undefined ) ).toBe(
+			baseView
+		);
+	} );
+
+	describe( 'scalar stripping', () => {
+		it( 'should strip a scalar key managed by overrides', () => {
+			const view: View = { ...baseView, titleField: 'name' };
+			const result = stripActiveViewOverrides( view, {
+				titleField: 'name',
+			} );
+			expect( result ).not.toHaveProperty( 'titleField' );
+		} );
+
+		it( 'should strip multiple scalar keys', () => {
+			const view: View = {
+				...baseView,
+				titleField: 'name',
+				showTitle: true,
+				mediaField: 'thumb',
+			};
+			const result = stripActiveViewOverrides( view, {
+				titleField: 'name',
+				showTitle: true,
+				mediaField: 'thumb',
+			} );
+			expect( result ).not.toHaveProperty( 'titleField' );
+			expect( result ).not.toHaveProperty( 'showTitle' );
+			expect( result ).not.toHaveProperty( 'mediaField' );
+		} );
+
+		it( 'should preserve non-overridden scalar keys', () => {
+			const view: View = {
+				...baseView,
+				titleField: 'name',
+				descriptionField: 'excerpt',
+			};
+			const result = stripActiveViewOverrides( view, {
+				titleField: 'name',
+			} );
+			expect( result ).not.toHaveProperty( 'titleField' );
+			expect( result.descriptionField ).toBe( 'excerpt' );
+		} );
+	} );
+
+	describe( 'filter stripping', () => {
+		it( 'should remove filters on managed fields', () => {
+			const view: View = {
+				...baseView,
+				filters: [
+					{
+						field: 'status',
+						operator: 'isAny',
+						value: 'publish',
+					},
+					{
+						field: 'author',
+						operator: 'isAny',
+						value: [ 'admin' ],
+					},
+				],
+			};
+			const result = stripActiveViewOverrides( view, {
+				filters: [
+					{
+						field: 'status',
+						operator: 'isAny',
+						value: 'publish',
+					},
+				],
+			} );
+			expect( result.filters ).toHaveLength( 1 );
+			expect( result.filters?.[ 0 ].field ).toBe( 'author' );
+		} );
+
+		it( 'should handle empty override filters', () => {
+			const result = stripActiveViewOverrides( baseView, {
+				filters: [],
+			} );
+			expect( result.filters ).toEqual( baseView.filters );
+		} );
+	} );
+
+	describe( 'sort stripping', () => {
+		it( 'should restore default sort when current matches override', () => {
+			const view: View = {
+				...baseView,
+				sort: { field: 'title', direction: 'asc' },
+			};
+			const result = stripActiveViewOverrides(
+				view,
+				{ sort: { field: 'title', direction: 'asc' } },
+				defaultView
+			);
+			expect( result.sort ).toEqual( defaultView.sort );
+		} );
+
+		it( 'should not change sort when it does not match override', () => {
+			const view: View = {
+				...baseView,
+				sort: { field: 'author', direction: 'asc' },
+			};
+			const result = stripActiveViewOverrides(
+				view,
+				{ sort: { field: 'title', direction: 'asc' } },
+				defaultView
+			);
+			expect( result.sort ).toEqual( {
+				field: 'author',
+				direction: 'asc',
+			} );
+		} );
+	} );
+
+	describe( 'layout stripping', () => {
+		it( 'should strip layout keys managed by overrides', () => {
+			const view: View = {
+				...baseView,
+				layout: {
+					density: 'compact',
+					styles: { author: { align: 'end' } },
+				},
+			};
+			const result = stripActiveViewOverrides( view, {
+				layout: { styles: { author: { align: 'end' } } },
+			} );
+			expect( result.layout ).toEqual( { density: 'compact' } );
+		} );
+
+		it( 'should set layout to undefined when all keys are stripped', () => {
+			const view: View = {
+				...baseView,
+				layout: {
+					styles: { author: { align: 'end' } },
+				},
+			};
+			const result = stripActiveViewOverrides( view, {
+				layout: { styles: { author: { align: 'end' } } },
+			} );
+			expect( result.layout ).toBeUndefined();
+		} );
+
+		it( 'should not touch layout when view has no layout', () => {
+			const result = stripActiveViewOverrides( baseView, {
+				layout: { styles: {} },
+			} );
+			expect( result ).not.toHaveProperty( 'layout' );
+		} );
+	} );
+
+	describe( 'groupBy stripping', () => {
+		it( 'should remove groupBy when managed by overrides', () => {
+			const view: View = {
+				...baseView,
+				groupBy: {
+					field: 'status',
+					direction: 'asc',
+					showLabel: true,
+				},
+			};
+			const result = stripActiveViewOverrides( view, {
+				groupBy: { field: 'category', direction: 'desc' },
+			} );
+			expect( result ).not.toHaveProperty( 'groupBy' );
+		} );
+
+		it( 'should not touch groupBy when view has no groupBy', () => {
+			const result = stripActiveViewOverrides( baseView, {
+				groupBy: { field: 'category', direction: 'asc' },
+			} );
+			expect( result ).not.toHaveProperty( 'groupBy' );
+		} );
+	} );
+
+	it( 'should not mutate the original view', () => {
+		const view: View = {
+			...baseView,
+			titleField: 'name',
+			layout: { density: 'compact', styles: { a: { width: '1px' } } },
+		};
+		const original = { ...view, layout: { ...view.layout } };
+		stripActiveViewOverrides( view, {
+			titleField: 'name',
+			layout: { styles: {} },
+		} );
+		expect( view ).toEqual( original );
+	} );
+} );
+
+describe( 'merge + strip round-trip', () => {
+	it( 'should strip what merge added for scalar overrides', () => {
+		const overrides = {
+			titleField: 'name' as const,
+			showMedia: true as const,
+		};
+		const merged = mergeActiveViewOverrides( baseView, overrides );
+		const stripped = stripActiveViewOverrides( merged, overrides );
+		expect( stripped ).not.toHaveProperty( 'titleField' );
+		expect( stripped ).not.toHaveProperty( 'showMedia' );
+		// Original fields remain.
+		expect( stripped.type ).toBe( 'table' );
+		expect( stripped.sort ).toEqual( baseView.sort );
+	} );
+
+	it( 'should strip what merge added for layout overrides', () => {
+		const overrides = {
+			layout: { styles: { author: { align: 'end' } } },
+		};
+		const view: View = {
+			...baseView,
+			layout: { density: 'compact' },
+		};
+		const merged = mergeActiveViewOverrides( view, overrides );
+		const stripped = stripActiveViewOverrides( merged, overrides );
+		expect( stripped.layout ).toEqual( { density: 'compact' } );
+	} );
+
+	it( 'should strip what merge added for filter overrides', () => {
+		const overrides = {
+			filters: [
+				{
+					field: 'status' as const,
+					operator: 'isAny' as const,
+					value: 'publish',
+				},
+			],
+		};
+		const merged = mergeActiveViewOverrides( baseView, overrides );
+		const stripped = stripActiveViewOverrides( merged, overrides );
+		// Only the original author filter should remain.
+		expect( stripped.filters ).toEqual( [
+			{ field: 'author', operator: 'isAny', value: [ 'admin' ] },
+		] );
+	} );
+} );

package/src/types.ts

@@ -1,7 +1,24 @@
 /**
  * WordPress dependencies
  */
-import type { View, Filter } from '@wordpress/dataviews';
+import type { View } from '@wordpress/dataviews';
+
+export type ActiveViewOverrides = {
+	// scalar values
+	titleField?: View[ 'titleField' ];
+	showTitle?: View[ 'showTitle' ];
+	mediaField?: View[ 'mediaField' ];
+	showMedia?: View[ 'showMedia' ];
+	descriptionField?: View[ 'descriptionField' ];
+	showDescription?: View[ 'showDescription' ];
+	showLevels?: View[ 'showLevels' ];
+	infiniteScrollEnabled?: View[ 'infiniteScrollEnabled' ];
+	// array & object values
+	filters?: View[ 'filters' ];
+	sort?: View[ 'sort' ];
+	groupBy?: View[ 'groupBy' ];
+	layout?: Record< string, unknown >;
+};
 
 export interface ViewConfig {
 	/**
@@ -28,13 +45,11 @@ export interface ViewConfig {
 
 	/**
 	 * 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.
+	 * These represent tab-specific configuration (filters, sort) and
+	 * developer-defined view defaults that should override the persisted
+	 * view settings.
 	 */
-	activeViewOverrides?: {
-		filters?: Filter[];
-		sort?: View[ 'sort' ];
-	};
+	activeViewOverrides?: ActiveViewOverrides;
 
 	/**
 	 * Optional query parameters from URL (page, search)