@payloadcms/ui 4.0.0-internal.77191e5 → 4.0.0-internal.7b53b6d

package/dist/providers/ListQuery/index.js

@@ -1,6 +1,7 @@
 'use client';
 
 import { jsx as _jsx } from "react/jsx-runtime";
+import { dequal } from 'dequal/lite';
 import { transformWhereQuery, validateWhereQuery } from 'payload/shared';
 import * as qs from 'qs-esm';
 import React, { useCallback, useEffect, useMemo, useRef, useState } from 'react';
@@ -10,6 +11,7 @@ import { useRouteTransition } from '../../providers/RouteTransition/index.js';
 import { parseSearchParams } from '../../utilities/parseSearchParams.js';
 import { useRouter, useSearchParams } from '../RouterAdapter/index.js';
 import { ListQueryContext, ListQueryModifiedContext } from './context.js';
+import { getSearchWithListQuery } from './getSearchWithListQuery.js';
 import { mergeQuery } from './mergeQuery.js';
 import { sanitizeQuery } from './sanitizeQuery.js';
 export { useListQuery } from './context.js';
@@ -40,7 +42,7 @@ export const ListQueryProvider = ({
   const queryFromURL = useMemo(() => sanitizeQuery(parseSearchParams(rawSearchParams)), [rawSearchParams]);
   const [query, setQuery] = useState(() => {
     if (modifySearchParams) {
-      return queryFromURL;
+      return queryFromProps ? sanitizeQuery(queryFromProps) : queryFromURL;
     } else {
       return {
         limit: queryFromProps.limit,
@@ -48,9 +50,8 @@ export const ListQueryProvider = ({
       };
     }
   });
-  const refineListData = useCallback(
-  // eslint-disable-next-line @typescript-eslint/require-await
-  async (incomingQuery, modified_0) => {
+  const [searchInput, setSearchInput] = useState(query?.search || '');
+  const refineListData = useCallback(async (incomingQuery, modified_0) => {
     setModified(modified_0 ?? true);
     const newQuery = mergeQuery(query, incomingQuery, {
       defaults: {
@@ -58,21 +59,23 @@ export const ListQueryProvider = ({
         sort: queryFromProps.sort
       }
     });
+    let pendingUpdate = undefined;
     if (modifySearchParams) {
-      const search = `?${qs.stringify({
-        ...newQuery,
-        columns: JSON.stringify(newQuery.columns),
-        queryByGroup: JSON.stringify(newQuery.queryByGroup)
-      })}`;
+      const search = getSearchWithListQuery({
+        currentSearch: window.location.search,
+        query: newQuery,
+        updatedQuery: incomingQuery
+      });
       if (window.location.search !== search) {
-        startRouteTransition(() => router.replace(search, {
+        pendingUpdate = startRouteTransition(() => router.replace(search, {
           scroll: false
         }));
       }
     } else if (typeof onQueryChange === 'function') {
-      onQueryChange(newQuery);
+      pendingUpdate = onQueryChange(newQuery);
     }
     setQuery(newQuery);
+    await pendingUpdate;
   }, [query, queryFromProps.limit, queryFromProps.sort, modifySearchParams, onQueryChange, startRouteTransition, router]);
   const handlePageChange = useCallback(async arg => {
     await refineListData({
@@ -108,15 +111,28 @@ export const ListQueryProvider = ({
   * triggering a re-render.
   */
   const syncPropsToURL = useEffectEvent(() => {
+    // URL serialization omits empty draft conditions and compacts their array indexes.
+    // Preserve those rows on an equivalent server echo so the focused input stays mounted.
+    const shouldKeepDraftFilters = dequal(qs.parse(qs.stringify({
+      where: query?.where
+    }), {
+      depth: 10
+    }), qs.parse(qs.stringify({
+      where: queryFromProps?.where
+    }), {
+      depth: 10
+    }));
     const newQuery_0 = sanitizeQuery({
       ...(query || {}),
-      ...(queryFromProps || {})
+      ...(queryFromProps || {}),
+      ...(shouldKeepDraftFilters ? {
+        where: query?.where
+      } : {})
+    });
+    const search_1 = getSearchWithListQuery({
+      currentSearch: window.location.search,
+      query: newQuery_0
     });
-    const search_1 = `?${qs.stringify({
-      ...newQuery_0,
-      columns: JSON.stringify(newQuery_0.columns),
-      queryByGroup: JSON.stringify(newQuery_0.queryByGroup)
-    })}`;
     if (window.location.search !== search_1) {
       setQuery(newQuery_0);
       // Important: do not use router.replace here to avoid re-rendering.
@@ -172,7 +188,11 @@ export const ListQueryProvider = ({
       orderableFieldName,
       query,
       refineListData,
+      resolvedGroupBy: queryFromProps?.groupBy,
+      resolvedSearch: queryFromProps?.search,
+      searchInput,
       setModified,
+      setSearchInput,
       ...contextRef.current
     },
     children: /*#__PURE__*/_jsx(ListQueryModifiedContext, {

package/dist/providers/ListQuery/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["transformWhereQuery","validateWhereQuery","qs","React","useCallback","useEffect","useMemo","useRef","useState","useListDrawerContext","useEffectEvent","useRouteTransition","parseSearchParams","useRouter","useSearchParams","ListQueryContext","ListQueryModifiedContext","mergeQuery","sanitizeQuery","useListQuery","ListQueryProvider","children","collectionSlug","data","modifySearchParams","onQueryChange","onQueryChangeFromProps","orderableFieldName","query","queryFromProps","router","rawSearchParams","startRouteTransition","modified","setModified","contextRef","current","onQueryChangeFromContext","queryFromURL","setQuery","limit","sort","refineListData","incomingQuery","newQuery","defaults","search","stringify","columns","JSON","queryByGroup","window","location","replace","scroll","handlePageChange","arg","page","handlePerPageChange","handleSearchChange","undefined","handleSortChange","handleWhereChange","where","syncPropsToURL","replaceState","history","hasActiveFilters","normalizedWhere","or","some","orGroup","and","andGroup","field","Object","keys","operatorObj","operator","Boolean","_jsx","value","defaultLimit","isGroupingBy","groupBy"],"sources":["../../../src/providers/ListQuery/index.tsx"],"sourcesContent":["'use client'\nimport { type ListQuery, type Where } from 'payload'\nimport { transformWhereQuery, validateWhereQuery } from 'payload/shared'\nimport * as qs from 'qs-esm'\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react'\n\nimport type { IListQueryContext, ListQueryProps } from './types.js'\n\nimport { useListDrawerContext } from '../../elements/ListDrawer/Provider.js'\nimport { useEffectEvent } from '../../hooks/useEffectEvent.js'\nimport { useRouteTransition } from '../../providers/RouteTransition/index.js'\nimport { parseSearchParams } from '../../utilities/parseSearchParams.js'\nimport { useRouter, useSearchParams } from '../RouterAdapter/index.js'\nimport { ListQueryContext, ListQueryModifiedContext } from './context.js'\nimport { mergeQuery } from './mergeQuery.js'\nimport { sanitizeQuery } from './sanitizeQuery.js'\n\nexport { useListQuery } from './context.js'\n\nexport const ListQueryProvider: React.FC<ListQueryProps> = ({\n  children,\n  collectionSlug,\n  data,\n  modifySearchParams,\n  onQueryChange: onQueryChangeFromProps,\n  orderableFieldName,\n  query: queryFromProps,\n}) => {\n  // TODO: Investigate if this is still needed\n  'use no memo'\n\n  const router = useRouter()\n  const rawSearchParams = useSearchParams()\n  const { startRouteTransition } = useRouteTransition()\n  const [modified, setModified] = useState(false)\n  const contextRef = useRef({} as IListQueryContext)\n  contextRef.current.modified = modified\n\n  const { onQueryChange: onQueryChangeFromContext } = useListDrawerContext()\n  const onQueryChange = onQueryChangeFromContext || onQueryChangeFromProps\n\n  const queryFromURL = useMemo<ListQuery>(\n    () => sanitizeQuery(parseSearchParams(rawSearchParams)),\n    [rawSearchParams],\n  )\n\n  const [query, setQuery] = useState<ListQuery>(() => {\n    if (modifySearchParams) {\n      return queryFromURL\n    } else {\n      return {\n        limit: queryFromProps.limit,\n        sort: queryFromProps.sort,\n      }\n    }\n  })\n\n  const refineListData = useCallback(\n    // eslint-disable-next-line @typescript-eslint/require-await\n    async (incomingQuery: ListQuery, modified?: boolean) => {\n      setModified(modified ?? true)\n\n      const newQuery = mergeQuery(query, incomingQuery, {\n        defaults: {\n          limit: queryFromProps.limit,\n          sort: queryFromProps.sort,\n        },\n      })\n\n      if (modifySearchParams) {\n        const search = `?${qs.stringify({\n          ...newQuery,\n          columns: JSON.stringify(newQuery.columns),\n          queryByGroup: JSON.stringify(newQuery.queryByGroup),\n        })}`\n        if (window.location.search !== search) {\n          startRouteTransition(() => router.replace(search, { scroll: false }))\n        }\n      } else if (typeof onQueryChange === 'function') {\n        onQueryChange(newQuery)\n      }\n\n      setQuery(newQuery)\n    },\n    [\n      query,\n      queryFromProps.limit,\n      queryFromProps.sort,\n      modifySearchParams,\n      onQueryChange,\n      startRouteTransition,\n      router,\n    ],\n  )\n\n  const handlePageChange = useCallback(\n    async (arg: number) => {\n      await refineListData({ page: arg })\n    },\n    [refineListData],\n  )\n\n  const handlePerPageChange = React.useCallback(\n    async (arg: number) => {\n      await refineListData({ limit: arg, page: 1 })\n    },\n    [refineListData],\n  )\n\n  const handleSearchChange = useCallback(\n    async (arg: string) => {\n      const search = arg === '' ? undefined : arg\n      await refineListData({ search })\n    },\n    [refineListData],\n  )\n\n  const handleSortChange = useCallback(\n    async (sort: string) => {\n      await refineListData({ sort })\n    },\n    [refineListData],\n  )\n\n  const handleWhereChange = useCallback(\n    async (where: Where) => {\n      await refineListData({ where })\n    },\n    [refineListData],\n  )\n\n  /**\n   * The server component may pass props to this client component, e.g. from\n   * fetching the query from preferences.\n   * This effect is responsible for syncing the props back to the URL, without\n   * triggering a re-render.\n   */\n  const syncPropsToURL = useEffectEvent(() => {\n    const newQuery = sanitizeQuery({ ...(query || {}), ...(queryFromProps || {}) })\n\n    const search = `?${qs.stringify({\n      ...newQuery,\n      columns: JSON.stringify(newQuery.columns),\n      queryByGroup: JSON.stringify(newQuery.queryByGroup),\n    })}`\n\n    if (window.location.search !== search) {\n      setQuery(newQuery)\n      // Important: do not use router.replace here to avoid re-rendering.\n      // Go through the adapter's replaceState so routers that observe history\n      // mutations (e.g. TanStack) don't re-run their loader and double-load the\n      // view. Falls back to the native call for adapters that don't implement it.\n      if (router.replaceState) {\n        router.replaceState(search)\n      } else {\n        window.history.replaceState(null, '', search)\n      }\n    }\n  })\n\n  // If `query` is updated externally, update the local state\n  // E.g. when HMR runs, these properties may be different\n  useEffect(() => {\n    if (modifySearchParams && queryFromProps) {\n      syncPropsToURL()\n    }\n  }, [modifySearchParams, queryFromProps])\n\n  const hasActiveFilters = useMemo(() => {\n    if (!query?.where) {\n      return false\n    }\n\n    // Normalize flat/invalid where queries (e.g. `{ title: { equals } }`) into the\n    // `or/and` structure so they are detected the same way the WhereBuilder reads them.\n    const normalizedWhere = validateWhereQuery(query.where)\n      ? query.where\n      : transformWhereQuery(query.where)\n\n    return (normalizedWhere.or ?? []).some((orGroup) =>\n      (orGroup.and ?? []).some((andGroup) => {\n        const field = Object.keys(andGroup)[0]\n        if (!field) {\n          return false\n        }\n        const operatorObj = andGroup[field]\n        if (!operatorObj || typeof operatorObj !== 'object') {\n          return false\n        }\n        const operator = Object.keys(operatorObj)[0]\n        return Boolean(operator) && (operatorObj as Record<string, unknown>)[operator] !== undefined\n      }),\n    )\n  }, [query?.where])\n\n  return (\n    <ListQueryContext\n      value={{\n        collectionSlug,\n        data,\n        defaultLimit: data?.limit,\n        handlePageChange,\n        handlePerPageChange,\n        handleSearchChange,\n        handleSortChange,\n        handleWhereChange,\n        hasActiveFilters,\n        isGroupingBy: Boolean(query?.groupBy),\n        orderableFieldName,\n        query,\n        refineListData,\n        setModified,\n        ...contextRef.current,\n      }}\n    >\n      <ListQueryModifiedContext value={modified}>{children}</ListQueryModifiedContext>\n    </ListQueryContext>\n  )\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"index.js","names":["dequal","transformWhereQuery","validateWhereQuery","qs","React","useCallback","useEffect","useMemo","useRef","useState","useListDrawerContext","useEffectEvent","useRouteTransition","parseSearchParams","useRouter","useSearchParams","ListQueryContext","ListQueryModifiedContext","getSearchWithListQuery","mergeQuery","sanitizeQuery","useListQuery","ListQueryProvider","children","collectionSlug","data","modifySearchParams","onQueryChange","onQueryChangeFromProps","orderableFieldName","query","queryFromProps","router","rawSearchParams","startRouteTransition","modified","setModified","contextRef","current","onQueryChangeFromContext","queryFromURL","setQuery","limit","sort","searchInput","setSearchInput","search","refineListData","incomingQuery","newQuery","defaults","pendingUpdate","undefined","currentSearch","window","location","updatedQuery","replace","scroll","handlePageChange","arg","page","handlePerPageChange","handleSearchChange","handleSortChange","handleWhereChange","where","syncPropsToURL","shouldKeepDraftFilters","parse","stringify","depth","replaceState","history","hasActiveFilters","normalizedWhere","or","some","orGroup","and","andGroup","field","Object","keys","operatorObj","operator","Boolean","_jsx","value","defaultLimit","isGroupingBy","groupBy","resolvedGroupBy","resolvedSearch"],"sources":["../../../src/providers/ListQuery/index.tsx"],"sourcesContent":["'use client'\nimport type { ListQuery, Where } from 'payload'\n\nimport { dequal } from 'dequal/lite'\nimport { transformWhereQuery, validateWhereQuery } from 'payload/shared'\nimport * as qs from 'qs-esm'\nimport React, { useCallback, useEffect, useMemo, useRef, useState } from 'react'\n\nimport type { IListQueryContext, ListQueryProps } from './types.js'\n\nimport { useListDrawerContext } from '../../elements/ListDrawer/Provider.js'\nimport { useEffectEvent } from '../../hooks/useEffectEvent.js'\nimport { useRouteTransition } from '../../providers/RouteTransition/index.js'\nimport { parseSearchParams } from '../../utilities/parseSearchParams.js'\nimport { useRouter, useSearchParams } from '../RouterAdapter/index.js'\nimport { ListQueryContext, ListQueryModifiedContext } from './context.js'\nimport { getSearchWithListQuery } from './getSearchWithListQuery.js'\nimport { mergeQuery } from './mergeQuery.js'\nimport { sanitizeQuery } from './sanitizeQuery.js'\n\nexport { useListQuery } from './context.js'\n\nexport const ListQueryProvider: React.FC<ListQueryProps> = ({\n  children,\n  collectionSlug,\n  data,\n  modifySearchParams,\n  onQueryChange: onQueryChangeFromProps,\n  orderableFieldName,\n  query: queryFromProps,\n}) => {\n  // TODO: Investigate if this is still needed\n  'use no memo'\n\n  const router = useRouter()\n  const rawSearchParams = useSearchParams()\n  const { startRouteTransition } = useRouteTransition()\n  const [modified, setModified] = useState(false)\n  const contextRef = useRef({} as IListQueryContext)\n  contextRef.current.modified = modified\n\n  const { onQueryChange: onQueryChangeFromContext } = useListDrawerContext()\n  const onQueryChange = onQueryChangeFromContext || onQueryChangeFromProps\n\n  const queryFromURL = useMemo<ListQuery>(\n    () => sanitizeQuery(parseSearchParams(rawSearchParams)),\n    [rawSearchParams],\n  )\n\n  const [query, setQuery] = useState<ListQuery>(() => {\n    if (modifySearchParams) {\n      return queryFromProps ? sanitizeQuery(queryFromProps) : queryFromURL\n    } else {\n      return {\n        limit: queryFromProps.limit,\n        sort: queryFromProps.sort,\n      }\n    }\n  })\n\n  const [searchInput, setSearchInput] = useState(query?.search || '')\n\n  const refineListData = useCallback(\n    async (incomingQuery: ListQuery, modified?: boolean) => {\n      setModified(modified ?? true)\n\n      const newQuery = mergeQuery(query, incomingQuery, {\n        defaults: {\n          limit: queryFromProps.limit,\n          sort: queryFromProps.sort,\n        },\n      })\n\n      let pendingUpdate: Promise<unknown> | void = undefined\n\n      if (modifySearchParams) {\n        const search = getSearchWithListQuery({\n          currentSearch: window.location.search,\n          query: newQuery,\n          updatedQuery: incomingQuery,\n        })\n        if (window.location.search !== search) {\n          pendingUpdate = startRouteTransition(() => router.replace(search, { scroll: false }))\n        }\n      } else if (typeof onQueryChange === 'function') {\n        pendingUpdate = onQueryChange(newQuery)\n      }\n\n      setQuery(newQuery)\n      await pendingUpdate\n    },\n    [\n      query,\n      queryFromProps.limit,\n      queryFromProps.sort,\n      modifySearchParams,\n      onQueryChange,\n      startRouteTransition,\n      router,\n    ],\n  )\n\n  const handlePageChange = useCallback(\n    async (arg: number) => {\n      await refineListData({ page: arg })\n    },\n    [refineListData],\n  )\n\n  const handlePerPageChange = React.useCallback(\n    async (arg: number) => {\n      await refineListData({ limit: arg, page: 1 })\n    },\n    [refineListData],\n  )\n\n  const handleSearchChange = useCallback(\n    async (arg: string) => {\n      const search = arg === '' ? undefined : arg\n      await refineListData({ search })\n    },\n    [refineListData],\n  )\n\n  const handleSortChange = useCallback(\n    async (sort: string) => {\n      await refineListData({ sort })\n    },\n    [refineListData],\n  )\n\n  const handleWhereChange = useCallback(\n    async (where: Where) => {\n      await refineListData({ where })\n    },\n    [refineListData],\n  )\n\n  /**\n   * The server component may pass props to this client component, e.g. from\n   * fetching the query from preferences.\n   * This effect is responsible for syncing the props back to the URL, without\n   * triggering a re-render.\n   */\n  const syncPropsToURL = useEffectEvent(() => {\n    // URL serialization omits empty draft conditions and compacts their array indexes.\n    // Preserve those rows on an equivalent server echo so the focused input stays mounted.\n    const shouldKeepDraftFilters = dequal(\n      qs.parse(qs.stringify({ where: query?.where }), { depth: 10 }),\n      qs.parse(qs.stringify({ where: queryFromProps?.where }), { depth: 10 }),\n    )\n    const newQuery = sanitizeQuery({\n      ...(query || {}),\n      ...(queryFromProps || {}),\n      ...(shouldKeepDraftFilters ? { where: query?.where } : {}),\n    })\n\n    const search = getSearchWithListQuery({\n      currentSearch: window.location.search,\n      query: newQuery,\n    })\n\n    if (window.location.search !== search) {\n      setQuery(newQuery)\n      // Important: do not use router.replace here to avoid re-rendering.\n      // Go through the adapter's replaceState so routers that observe history\n      // mutations (e.g. TanStack) don't re-run their loader and double-load the\n      // view. Falls back to the native call for adapters that don't implement it.\n      if (router.replaceState) {\n        router.replaceState(search)\n      } else {\n        window.history.replaceState(null, '', search)\n      }\n    }\n  })\n\n  // If `query` is updated externally, update the local state\n  // E.g. when HMR runs, these properties may be different\n  useEffect(() => {\n    if (modifySearchParams && queryFromProps) {\n      syncPropsToURL()\n    }\n  }, [modifySearchParams, queryFromProps])\n\n  const hasActiveFilters = useMemo(() => {\n    if (!query?.where) {\n      return false\n    }\n\n    // Normalize flat/invalid where queries (e.g. `{ title: { equals } }`) into the\n    // `or/and` structure so they are detected the same way the WhereBuilder reads them.\n    const normalizedWhere = validateWhereQuery(query.where)\n      ? query.where\n      : transformWhereQuery(query.where)\n\n    return (normalizedWhere.or ?? []).some((orGroup) =>\n      (orGroup.and ?? []).some((andGroup) => {\n        const field = Object.keys(andGroup)[0]\n        if (!field) {\n          return false\n        }\n        const operatorObj = andGroup[field]\n        if (!operatorObj || typeof operatorObj !== 'object') {\n          return false\n        }\n        const operator = Object.keys(operatorObj)[0]\n        return Boolean(operator) && (operatorObj as Record<string, unknown>)[operator] !== undefined\n      }),\n    )\n  }, [query?.where])\n\n  return (\n    <ListQueryContext\n      value={{\n        collectionSlug,\n        data,\n        defaultLimit: data?.limit,\n        handlePageChange,\n        handlePerPageChange,\n        handleSearchChange,\n        handleSortChange,\n        handleWhereChange,\n        hasActiveFilters,\n        isGroupingBy: Boolean(query?.groupBy),\n        orderableFieldName,\n        query,\n        refineListData,\n        resolvedGroupBy: queryFromProps?.groupBy,\n        resolvedSearch: queryFromProps?.search,\n        searchInput,\n        setModified,\n        setSearchInput,\n        ...contextRef.current,\n      }}\n    >\n      <ListQueryModifiedContext value={modified}>{children}</ListQueryModifiedContext>\n    </ListQueryContext>\n  )\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/providers/ListQuery/mergeQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mergeQuery.d.ts","sourceRoot":"","sources":["../../../src/providers/ListQuery/mergeQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,eAAO,MAAM,UAAU,iBACP,SAAS,YACb,SAAS,YACT;IACR,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,KACA,SAwDF,CAAA"}
+{"version":3,"file":"mergeQuery.d.ts","sourceRoot":"","sources":["../../../src/providers/ListQuery/mergeQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC,eAAO,MAAM,UAAU,iBACP,SAAS,YACb,SAAS,YACT;IACR,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,KACA,SAqDF,CAAA"}

package/dist/providers/ListQuery/mergeQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"mergeQuery.js","names":["mergeQuery","currentQuery","newQuery","options","page","shouldResetPage","some","key","includes","shouldResetQueryByGroup","mergedQueryByGroup","undefined","queryByGroup","Object","fromEntries","entries","map","value","mergedQuery","columns","groupBy","defaults","limit","preset","search","sort","where"],"sources":["../../../src/providers/ListQuery/mergeQuery.ts"],"sourcesContent":["import type { ListQuery } from 'payload'\n\nexport const mergeQuery = (\n  currentQuery: ListQuery,\n  newQuery: ListQuery,\n  options?: {\n    defaults?: ListQuery\n  },\n): ListQuery => {\n  let page = 'page' in newQuery ? newQuery.page : currentQuery?.page\n\n  const shouldResetPage = ['where', 'search', 'groupBy']?.some(\n    (key) => key in newQuery && !['limit', 'page'].includes(key),\n  )\n\n  if (shouldResetPage) {\n    page = 1\n  }\n\n  const shouldResetQueryByGroup = ['where', 'search', 'page', 'limit', 'groupBy', 'sort'].some(\n    (key) => key in newQuery,\n  )\n\n  let mergedQueryByGroup = undefined\n\n  if (!shouldResetQueryByGroup) {\n    // Deeply merge queryByGroup so we can send a partial update for a specific group\n    mergedQueryByGroup = {\n      ...(currentQuery?.queryByGroup || {}),\n      ...(newQuery.queryByGroup\n        ? Object.fromEntries(\n            Object.entries(newQuery.queryByGroup).map(([key, value]) => [\n              key,\n              {\n                ...(currentQuery?.queryByGroup?.[key] || {}),\n                ...value,\n              },\n            ]),\n          )\n        : {}),\n    }\n  }\n\n  const mergedQuery: ListQuery = {\n    ...currentQuery,\n    ...newQuery,\n    columns: 'columns' in newQuery ? newQuery.columns : currentQuery.columns,\n    groupBy:\n      'groupBy' in newQuery\n        ? newQuery.groupBy\n        : (currentQuery?.groupBy ?? options?.defaults?.groupBy),\n    limit: 'limit' in newQuery ? newQuery.limit : (currentQuery?.limit ?? options?.defaults?.limit),\n    page,\n    preset: 'preset' in newQuery ? newQuery.preset : currentQuery?.preset,\n    queryByGroup: mergedQueryByGroup,\n    search: 'search' in newQuery ? newQuery.search : currentQuery?.search,\n    sort:\n      'sort' in newQuery\n        ? newQuery.sort\n        : ((currentQuery?.sort as string) ?? options?.defaults?.sort),\n    where: 'where' in newQuery ? newQuery.where : currentQuery?.where,\n  }\n\n  return mergedQuery\n}\n"],"mappings":"AAEA,OAAO,MAAMA,UAAA,GAAaA,CACxBC,YAAA,EACAC,QAAA,EACAC,OAAA;EAIA,IAAIC,IAAA,GAAO,UAAUF,QAAA,GAAWA,QAAA,CAASE,IAAI,GAAGH,YAAA,EAAcG,IAAA;EAE9D,MAAMC,eAAA,GAAkB,CAAC,SAAS,UAAU,UAAU,EAAEC,IAAA,CACrDC,GAAA,IAAQA,GAAA,IAAOL,QAAA,IAAY,CAAC,CAAC,SAAS,OAAO,CAACM,QAAQ,CAACD,GAAA;EAG1D,IAAIF,eAAA,EAAiB;IACnBD,IAAA,GAAO;EACT;EAEA,MAAMK,uBAAA,GAA0B,CAAC,SAAS,UAAU,QAAQ,SAAS,WAAW,OAAO,CAACH,IAAI,CACzFC,GAAA,IAAQA,GAAA,IAAOL,QAAA;EAGlB,IAAIQ,kBAAA,GAAqBC,SAAA;EAEzB,IAAI,CAACF,uBAAA,EAAyB;IAC5B;IACAC,kBAAA,GAAqB;MACnB,IAAIT,YAAA,EAAcW,YAAA,IAAgB,CAAC,CAAC;MACpC,IAAIV,QAAA,CAASU,YAAY,GACrBC,MAAA,CAAOC,WAAW,CAChBD,MAAA,CAAOE,OAAO,CAACb,QAAA,CAASU,YAAY,EAAEI,GAAG,CAAC,CAAC,CAACT,GAAA,EAAKU,KAAA,CAAM,KAAK,CAC1DV,GAAA,EACA;QACE,IAAIN,YAAA,EAAcW,YAAA,GAAeL,GAAA,CAAI,IAAI,CAAC,CAAC;QAC3C,GAAGU;MACL,EACD,KAEH,CAAC,CAAC;IACR;EACF;EAEA,MAAMC,WAAA,GAAyB;IAC7B,GAAGjB,YAAY;IACf,GAAGC,QAAQ;IACXiB,OAAA,EAAS,aAAajB,QAAA,GAAWA,QAAA,CAASiB,OAAO,GAAGlB,YAAA,CAAakB,OAAO;IACxEC,OAAA,EACE,aAAalB,QAAA,GACTA,QAAA,CAASkB,OAAO,GACfnB,YAAA,EAAcmB,OAAA,IAAWjB,OAAA,EAASkB,QAAA,EAAUD,OAAA;IACnDE,KAAA,EAAO,WAAWpB,QAAA,GAAWA,QAAA,CAASoB,KAAK,GAAIrB,YAAA,EAAcqB,KAAA,IAASnB,OAAA,EAASkB,QAAA,EAAUC,KAAA;IACzFlB,IAAA;IACAmB,MAAA,EAAQ,YAAYrB,QAAA,GAAWA,QAAA,CAASqB,MAAM,GAAGtB,YAAA,EAAcsB,MAAA;IAC/DX,YAAA,EAAcF,kBAAA;IACdc,MAAA,EAAQ,YAAYtB,QAAA,GAAWA,QAAA,CAASsB,MAAM,GAAGvB,YAAA,EAAcuB,MAAA;IAC/DC,IAAA,EACE,UAAUvB,QAAA,GACNA,QAAA,CAASuB,IAAI,GACZxB,YAAC,EAAcwB,IAAA,IAAmBtB,OAAA,EAASkB,QAAA,EAAUI,IAAA;IAC5DC,KAAA,EAAO,WAAWxB,QAAA,GAAWA,QAAA,CAASwB,KAAK,GAAGzB,YAAA,EAAcyB;EAC9D;EAEA,OAAOR,WAAA;AACT","ignoreList":[]}
+{"version":3,"file":"mergeQuery.js","names":["mergeQuery","currentQuery","newQuery","options","page","shouldResetPage","some","key","includes","shouldResetQueryByGroup","mergedQueryByGroup","undefined","queryByGroup","Object","fromEntries","entries","map","value","mergedQuery","columns","groupBy","defaults","limit","preset","search","sort","where"],"sources":["../../../src/providers/ListQuery/mergeQuery.ts"],"sourcesContent":["import type { ListQuery } from 'payload'\n\nexport const mergeQuery = (\n  currentQuery: ListQuery,\n  newQuery: ListQuery,\n  options?: {\n    defaults?: ListQuery\n  },\n): ListQuery => {\n  let page = 'page' in newQuery ? newQuery.page : currentQuery?.page\n\n  const shouldResetPage = ['where', 'search', 'groupBy']?.some(\n    (key) => key in newQuery && !['limit', 'page'].includes(key),\n  )\n\n  if (shouldResetPage) {\n    page = 1\n  }\n\n  const shouldResetQueryByGroup = ['where', 'search', 'page', 'limit', 'groupBy', 'sort'].some(\n    (key) => key in newQuery,\n  )\n\n  let mergedQueryByGroup = undefined\n\n  if (!shouldResetQueryByGroup) {\n    // Deeply merge queryByGroup so we can send a partial update for a specific group\n    mergedQueryByGroup = {\n      ...(currentQuery?.queryByGroup || {}),\n      ...(newQuery.queryByGroup\n        ? Object.fromEntries(\n            Object.entries(newQuery.queryByGroup).map(([key, value]) => [\n              key,\n              {\n                ...(currentQuery?.queryByGroup?.[key] || {}),\n                ...value,\n              },\n            ]),\n          )\n        : {}),\n    }\n  }\n\n  const mergedQuery: ListQuery = {\n    ...currentQuery,\n    ...newQuery,\n    columns: 'columns' in newQuery ? newQuery.columns : currentQuery.columns,\n    groupBy:\n      'groupBy' in newQuery\n        ? newQuery.groupBy\n        : (currentQuery?.groupBy ?? options?.defaults?.groupBy),\n    limit: 'limit' in newQuery ? newQuery.limit : (currentQuery?.limit ?? options?.defaults?.limit),\n    page,\n    preset: 'preset' in newQuery ? newQuery.preset : currentQuery?.preset,\n    queryByGroup: mergedQueryByGroup,\n    search: 'search' in newQuery ? newQuery.search : currentQuery?.search,\n    sort: 'sort' in newQuery ? newQuery.sort : (currentQuery?.sort ?? options?.defaults?.sort),\n    where: 'where' in newQuery ? newQuery.where : currentQuery?.where,\n  }\n\n  return mergedQuery\n}\n"],"mappings":"AAEA,OAAO,MAAMA,UAAA,GAAaA,CACxBC,YAAA,EACAC,QAAA,EACAC,OAAA;EAIA,IAAIC,IAAA,GAAO,UAAUF,QAAA,GAAWA,QAAA,CAASE,IAAI,GAAGH,YAAA,EAAcG,IAAA;EAE9D,MAAMC,eAAA,GAAkB,CAAC,SAAS,UAAU,UAAU,EAAEC,IAAA,CACrDC,GAAA,IAAQA,GAAA,IAAOL,QAAA,IAAY,CAAC,CAAC,SAAS,OAAO,CAACM,QAAQ,CAACD,GAAA;EAG1D,IAAIF,eAAA,EAAiB;IACnBD,IAAA,GAAO;EACT;EAEA,MAAMK,uBAAA,GAA0B,CAAC,SAAS,UAAU,QAAQ,SAAS,WAAW,OAAO,CAACH,IAAI,CACzFC,GAAA,IAAQA,GAAA,IAAOL,QAAA;EAGlB,IAAIQ,kBAAA,GAAqBC,SAAA;EAEzB,IAAI,CAACF,uBAAA,EAAyB;IAC5B;IACAC,kBAAA,GAAqB;MACnB,IAAIT,YAAA,EAAcW,YAAA,IAAgB,CAAC,CAAC;MACpC,IAAIV,QAAA,CAASU,YAAY,GACrBC,MAAA,CAAOC,WAAW,CAChBD,MAAA,CAAOE,OAAO,CAACb,QAAA,CAASU,YAAY,EAAEI,GAAG,CAAC,CAAC,CAACT,GAAA,EAAKU,KAAA,CAAM,KAAK,CAC1DV,GAAA,EACA;QACE,IAAIN,YAAA,EAAcW,YAAA,GAAeL,GAAA,CAAI,IAAI,CAAC,CAAC;QAC3C,GAAGU;MACL,EACD,KAEH,CAAC,CAAC;IACR;EACF;EAEA,MAAMC,WAAA,GAAyB;IAC7B,GAAGjB,YAAY;IACf,GAAGC,QAAQ;IACXiB,OAAA,EAAS,aAAajB,QAAA,GAAWA,QAAA,CAASiB,OAAO,GAAGlB,YAAA,CAAakB,OAAO;IACxEC,OAAA,EACE,aAAalB,QAAA,GACTA,QAAA,CAASkB,OAAO,GACfnB,YAAA,EAAcmB,OAAA,IAAWjB,OAAA,EAASkB,QAAA,EAAUD,OAAA;IACnDE,KAAA,EAAO,WAAWpB,QAAA,GAAWA,QAAA,CAASoB,KAAK,GAAIrB,YAAA,EAAcqB,KAAA,IAASnB,OAAA,EAASkB,QAAA,EAAUC,KAAA;IACzFlB,IAAA;IACAmB,MAAA,EAAQ,YAAYrB,QAAA,GAAWA,QAAA,CAASqB,MAAM,GAAGtB,YAAA,EAAcsB,MAAA;IAC/DX,YAAA,EAAcF,kBAAA;IACdc,MAAA,EAAQ,YAAYtB,QAAA,GAAWA,QAAA,CAASsB,MAAM,GAAGvB,YAAA,EAAcuB,MAAA;IAC/DC,IAAA,EAAM,UAAUvB,QAAA,GAAWA,QAAA,CAASuB,IAAI,GAAIxB,YAAA,EAAcwB,IAAA,IAAQtB,OAAA,EAASkB,QAAA,EAAUI,IAAA;IACrFC,KAAA,EAAO,WAAWxB,QAAA,GAAWA,QAAA,CAASwB,KAAK,GAAGzB,YAAA,EAAcyB;EAC9D;EAEA,OAAOR,WAAA;AACT","ignoreList":[]}

package/dist/providers/ListQuery/sanitizeQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"sanitizeQuery.js","names":["sanitizeQuery","toSanitize","sanitized","Object","entries","forEach","key","value","Array","isArray","length","keys","parsed","parseInt","Number","isNaN","undefined"],"sources":["../../../src/providers/ListQuery/sanitizeQuery.ts"],"sourcesContent":["import type { ListQuery, Where } from 'payload'\n\n/**\n * Sanitize empty strings from the query, e.g. `?preset=`\n * This is how we determine whether to clear user preferences for certain params\n * Once cleared, they are no longer needed in the URL\n */\nexport const sanitizeQuery = (toSanitize: ListQuery): ListQuery => {\n  const sanitized = { ...toSanitize }\n\n  Object.entries(sanitized).forEach(([key, value]) => {\n    if (\n      key === 'columns' &&\n      (value === '[]' || (Array.isArray(sanitized[key]) && sanitized[key].length === 0))\n    ) {\n      delete sanitized[key]\n    }\n\n    if (\n      key === 'where' &&\n      typeof value === 'object' &&\n      value !== null &&\n      !Object.keys(value as Where).length\n    ) {\n      delete sanitized[key]\n    }\n\n    if ((key === 'limit' || key === 'page') && typeof value === 'string') {\n      const parsed = parseInt(value, 10)\n      sanitized[key] = Number.isNaN(parsed) ? undefined : parsed\n    }\n\n    if (key === 'page' && value === 0) {\n      delete sanitized[key]\n    }\n\n    if (value === '') {\n      delete sanitized[key]\n    }\n  })\n\n  return sanitized\n}\n"],"mappings":"AAEA;;;;GAKA,OAAO,MAAMA,aAAA,GAAiBC,UAAA;EAC5B,MAAMC,SAAA,GAAY;IAAE,GAAGD;EAAW;EAElCE,MAAA,CAAOC,OAAO,CAACF,SAAA,EAAWG,OAAO,CAAC,CAAC,CAACC,GAAA,EAAKC,KAAA,CAAM;IAC7C,IACED,GAAA,KAAQ,cACPC,KAAA,KAAU,QAASC,KAAA,CAAMC,OAAO,CAACP,SAAS,CAACI,GAAA,CAAI,KAAKJ,SAAS,CAACI,GAAA,CAAI,CAACI,MAAM,KAAK,CAAC,GAChF;MACA,OAAOR,SAAS,CAACI,GAAA,CAAI;IACvB;IAEA,IACEA,GAAA,KAAQ,WACR,OAAOC,KAAA,KAAU,YACjBA,KAAA,KAAU,QACV,CAACJ,MAAA,CAAOQ,IAAI,CAACJ,KAAA,EAAgBG,MAAM,EACnC;MACA,OAAOR,SAAS,CAACI,GAAA,CAAI;IACvB;IAEA,IAAI,CAACA,GAAA,KAAQ,WAAWA,GAAA,KAAQ,MAAK,KAAM,OAAOC,KAAA,KAAU,UAAU;MACpE,MAAMK,MAAA,GAASC,QAAA,CAASN,KAAA,EAAO;MAC/BL,SAAS,CAACI,GAAA,CAAI,GAAGQ,MAAA,CAAOC,KAAK,CAACH,MAAA,IAAUI,SAAA,GAAYJ,MAAA;IACtD;IAEA,IAAIN,GAAA,KAAQ,UAAUC,KAAA,KAAU,GAAG;MACjC,OAAOL,SAAS,CAACI,GAAA,CAAI;IACvB;IAEA,IAAIC,KAAA,KAAU,IAAI;MAChB,OAAOL,SAAS,CAACI,GAAA,CAAI;IACvB;EACF;EAEA,OAAOJ,SAAA;AACT","ignoreList":[]}
+{"version":3,"file":"sanitizeQuery.js","names":["sanitizeQuery","toSanitize","sanitized","Object","entries","forEach","key","value","Array","isArray","length","keys","parsed","parseInt","Number","isNaN","undefined"],"sources":["../../../src/providers/ListQuery/sanitizeQuery.ts"],"sourcesContent":["import type { ListQuery, Where } from 'payload'\n\n/**\n * Sanitize empty strings from the query, e.g. `?preset=`\n * This is how we determine whether to clear user preferences for certain params\n * Once cleared, they are no longer needed in the URL\n */\nexport const sanitizeQuery = (toSanitize: ListQuery): ListQuery => {\n  const sanitized = { ...toSanitize }\n\n  Object.entries(sanitized).forEach(([key, value]) => {\n    if (\n      key === 'columns' &&\n      (value === '[]' || (Array.isArray(sanitized[key]) && sanitized[key].length === 0))\n    ) {\n      delete sanitized[key]\n    }\n\n    if (\n      key === 'where' &&\n      typeof value === 'object' &&\n      value !== null &&\n      !Object.keys(value).length\n    ) {\n      delete sanitized[key]\n    }\n\n    if ((key === 'limit' || key === 'page') && typeof value === 'string') {\n      const parsed = parseInt(value, 10)\n      sanitized[key] = Number.isNaN(parsed) ? undefined : parsed\n    }\n\n    if (key === 'page' && value === 0) {\n      delete sanitized[key]\n    }\n\n    if (value === '') {\n      delete sanitized[key]\n    }\n  })\n\n  return sanitized\n}\n"],"mappings":"AAEA;;;;GAKA,OAAO,MAAMA,aAAA,GAAiBC,UAAA;EAC5B,MAAMC,SAAA,GAAY;IAAE,GAAGD;EAAW;EAElCE,MAAA,CAAOC,OAAO,CAACF,SAAA,EAAWG,OAAO,CAAC,CAAC,CAACC,GAAA,EAAKC,KAAA,CAAM;IAC7C,IACED,GAAA,KAAQ,cACPC,KAAA,KAAU,QAASC,KAAA,CAAMC,OAAO,CAACP,SAAS,CAACI,GAAA,CAAI,KAAKJ,SAAS,CAACI,GAAA,CAAI,CAACI,MAAM,KAAK,CAAC,GAChF;MACA,OAAOR,SAAS,CAACI,GAAA,CAAI;IACvB;IAEA,IACEA,GAAA,KAAQ,WACR,OAAOC,KAAA,KAAU,YACjBA,KAAA,KAAU,QACV,CAACJ,MAAA,CAAOQ,IAAI,CAACJ,KAAA,EAAOG,MAAM,EAC1B;MACA,OAAOR,SAAS,CAACI,GAAA,CAAI;IACvB;IAEA,IAAI,CAACA,GAAA,KAAQ,WAAWA,GAAA,KAAQ,MAAK,KAAM,OAAOC,KAAA,KAAU,UAAU;MACpE,MAAMK,MAAA,GAASC,QAAA,CAASN,KAAA,EAAO;MAC/BL,SAAS,CAACI,GAAA,CAAI,GAAGQ,MAAA,CAAOC,KAAK,CAACH,MAAA,IAAUI,SAAA,GAAYJ,MAAA;IACtD;IAEA,IAAIN,GAAA,KAAQ,UAAUC,KAAA,KAAU,GAAG;MACjC,OAAOL,SAAS,CAACI,GAAA,CAAI;IACvB;IAEA,IAAIC,KAAA,KAAU,IAAI;MAChB,OAAOL,SAAS,CAACI,GAAA,CAAI;IACvB;EACF;EAEA,OAAOJ,SAAA;AACT","ignoreList":[]}

package/dist/providers/ListQuery/types.d.ts

@@ -6,7 +6,12 @@ type ContextHandlers = {
     handleSortChange?: (sort: string) => Promise<void>;
     handleWhereChange?: (where: Where) => Promise<void>;
 };
-export type OnListQueryChange = (query: ListQuery) => void;
+/**
+ * Returned promises are awaited; return values are otherwise ignored.
+ * The union of callbacks preserves TypeScript's `void` callback rule, allowing handlers such as `query => updates.push(query)`.
+ * A union of return types would reject synchronous handlers that return a value.
+ */
+export type OnListQueryChange = ((query: ListQuery) => Promise<unknown>) | ((query: ListQuery) => void);
 export type ListQueryProps = {
     readonly children: React.ReactNode;
     readonly collectionSlug?: ClientCollectionConfig['slug'];
@@ -14,10 +19,6 @@ export type ListQueryProps = {
     readonly modifySearchParams?: boolean;
     readonly onQueryChange?: OnListQueryChange;
     readonly orderableFieldName?: string;
-    /**
-     * @deprecated
-     */
-    readonly preferenceKey?: string;
     readonly query?: ListQuery;
 };
 export type IListQueryContext = {
@@ -35,7 +36,11 @@ export type IListQueryContext = {
     orderableFieldName?: string;
     query: ListQuery;
     refineListData: (args: ListQuery, setModified?: boolean) => Promise<void>;
+    resolvedGroupBy?: string;
+    resolvedSearch?: string;
+    searchInput: string;
     setModified: (modified: boolean) => void;
+    setSearchInput: (search: string) => void;
 } & ContextHandlers;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/providers/ListQuery/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/ListQuery/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,SAAS,EAET,aAAa,EACb,IAAI,EACJ,KAAK,EACN,MAAM,SAAS,CAAA;AAEhB,KAAK,eAAe,GAAG;IACrB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpD,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAA;AAE1D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;IACxD,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAA;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IACpC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC9C,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,8EAA8E;IAC9E,gBAAgB,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,SAAS,CAAA;IAChB,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;CACzC,GAAG,eAAe,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/providers/ListQuery/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,SAAS,EAET,aAAa,EACb,IAAI,EACJ,KAAK,EACN,MAAM,SAAS,CAAA;AAEhB,KAAK,eAAe,GAAG;IACrB,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACtD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACpD,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GACzB,CAAC,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GACxC,CAAC,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC,CAAA;AAEhC,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;IACxD,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAA;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,cAAc,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAA;IAC9C,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAA;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,IAAI,CAAA;IAClB,8EAA8E;IAC9E,gBAAgB,EAAE,OAAO,CAAA;IACzB;;OAEG;IACH,YAAY,EAAE,OAAO,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAA;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,KAAK,EAAE,SAAS,CAAA;IAChB,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzE,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;IACxC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;CACzC,GAAG,eAAe,CAAA"}

package/dist/providers/ListQuery/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/providers/ListQuery/types.ts"],"sourcesContent":["import type {\n  ClientCollectionConfig,\n  ListQuery,\n  PaginatedDistinctDocs,\n  PaginatedDocs,\n  Sort,\n  Where,\n} from 'payload'\n\ntype ContextHandlers = {\n  handlePageChange?: (page: number) => Promise<void>\n  handlePerPageChange?: (limit: number) => Promise<void>\n  handleSearchChange?: (search: string) => Promise<void>\n  handleSortChange?: (sort: string) => Promise<void>\n  handleWhereChange?: (where: Where) => Promise<void>\n}\n\nexport type OnListQueryChange = (query: ListQuery) => void\n\nexport type ListQueryProps = {\n  readonly children: React.ReactNode\n  readonly collectionSlug?: ClientCollectionConfig['slug']\n  readonly data: PaginatedDocs | undefined\n  readonly modifySearchParams?: boolean\n  readonly onQueryChange?: OnListQueryChange\n  readonly orderableFieldName?: string\n  /**\n   * @deprecated\n   */\n  readonly preferenceKey?: string\n  readonly query?: ListQuery\n}\n\nexport type IListQueryContext = {\n  collectionSlug: ClientCollectionConfig['slug']\n  data: ListQueryProps['data']\n  defaultLimit?: number\n  defaultSort?: Sort\n  /** True when the where query contains at least one condition with a value. */\n  hasActiveFilters: boolean\n  /**\n   * @experimental This prop is subject to change. Use at your own risk.\n   */\n  isGroupingBy: boolean\n  modified: boolean\n  orderableFieldName?: string\n  query: ListQuery\n  refineListData: (args: ListQuery, setModified?: boolean) => Promise<void>\n  setModified: (modified: boolean) => void\n} & ContextHandlers\n"],"mappings":"AAiCA","ignoreList":[]}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/providers/ListQuery/types.ts"],"sourcesContent":["import type {\n  ClientCollectionConfig,\n  ListQuery,\n  PaginatedDistinctDocs,\n  PaginatedDocs,\n  Sort,\n  Where,\n} from 'payload'\n\ntype ContextHandlers = {\n  handlePageChange?: (page: number) => Promise<void>\n  handlePerPageChange?: (limit: number) => Promise<void>\n  handleSearchChange?: (search: string) => Promise<void>\n  handleSortChange?: (sort: string) => Promise<void>\n  handleWhereChange?: (where: Where) => Promise<void>\n}\n\n/**\n * Returned promises are awaited; return values are otherwise ignored.\n * The union of callbacks preserves TypeScript's `void` callback rule, allowing handlers such as `query => updates.push(query)`.\n * A union of return types would reject synchronous handlers that return a value.\n */\nexport type OnListQueryChange =\n  | ((query: ListQuery) => Promise<unknown>)\n  | ((query: ListQuery) => void)\n\nexport type ListQueryProps = {\n  readonly children: React.ReactNode\n  readonly collectionSlug?: ClientCollectionConfig['slug']\n  readonly data: PaginatedDocs | undefined\n  readonly modifySearchParams?: boolean\n  readonly onQueryChange?: OnListQueryChange\n  readonly orderableFieldName?: string\n  readonly query?: ListQuery\n}\n\nexport type IListQueryContext = {\n  collectionSlug: ClientCollectionConfig['slug']\n  data: ListQueryProps['data']\n  defaultLimit?: number\n  defaultSort?: Sort\n  /** True when the where query contains at least one condition with a value. */\n  hasActiveFilters: boolean\n  /**\n   * @experimental This prop is subject to change. Use at your own risk.\n   */\n  isGroupingBy: boolean\n  modified: boolean\n  orderableFieldName?: string\n  query: ListQuery\n  refineListData: (args: ListQuery, setModified?: boolean) => Promise<void>\n  resolvedGroupBy?: string\n  resolvedSearch?: string\n  searchInput: string\n  setModified: (modified: boolean) => void\n  setSearchInput: (search: string) => void\n} & ContextHandlers\n"],"mappings":"AAoCA","ignoreList":[]}

package/dist/providers/ModalAccessibility/index.d.ts

@@ -0,0 +1,3 @@
+/** Keeps the page and lower modal layers out of navigation while the top modal is open. */
+export declare function ModalAccessibility(): any;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/ModalAccessibility/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/ModalAccessibility/index.tsx"],"names":[],"mappings":"AAOA,2FAA2F;AAC3F,wBAAgB,kBAAkB,QAmEjC"}

package/dist/providers/ModalAccessibility/index.js

@@ -0,0 +1,102 @@
+'use client';
+
+import { c as _c } from "react/compiler-runtime";
+import { useModal } from '@faceless-ui/modal';
+import { useLayoutEffect } from 'react';
+import { getActiveModal } from '../../utilities/getActiveModal.js';
+/** Keeps the page and lower modal layers out of navigation while the top modal is open. */
+export function ModalAccessibility() {
+  const $ = _c(3);
+  const {
+    modalState
+  } = useModal();
+  let t0;
+  let t1;
+  if ($[0] !== modalState) {
+    t0 = () => {
+      if (!Object.values(modalState).some(_temp)) {
+        return;
+      }
+      const restoredInert = new Map();
+      const restore = () => {
+        for (const [element, wasInert] of restoredInert) {
+          restoreBackgroundElement({
+            element,
+            state: wasInert
+          });
+        }
+        restoredInert.clear();
+      };
+      const update = () => {
+        const activeModal = getActiveModal({
+          modalState
+        });
+        const background = new Set();
+        let current = activeModal;
+        while (current && current !== document.body) {
+          for (const sibling of current.parentElement?.children ?? []) {
+            if (sibling !== current && sibling instanceof HTMLElement) {
+              background.add(sibling);
+            }
+          }
+          current = current.parentElement;
+        }
+        for (const [element_0, wasInert_0] of restoredInert) {
+          if (!background.has(element_0)) {
+            restoreBackgroundElement({
+              element: element_0,
+              state: wasInert_0
+            });
+            restoredInert.delete(element_0);
+          }
+        }
+        for (const element_1 of background) {
+          if (!restoredInert.has(element_1)) {
+            restoredInert.set(element_1, {
+              ariaHidden: element_1.getAttribute("aria-hidden"),
+              inert: element_1.inert
+            });
+            element_1.inert = true;
+            element_1.setAttribute("aria-hidden", "true");
+          }
+        }
+      };
+      update();
+      const observer = new MutationObserver(update);
+      observer.observe(document.body, {
+        attributeFilter: ["open"],
+        attributes: true,
+        childList: true,
+        subtree: true
+      });
+      return () => {
+        observer.disconnect();
+        restore();
+      };
+    };
+    t1 = [modalState];
+    $[0] = modalState;
+    $[1] = t0;
+    $[2] = t1;
+  } else {
+    t0 = $[1];
+    t1 = $[2];
+  }
+  useLayoutEffect(t0, t1);
+  return null;
+}
+function _temp(modal) {
+  return modal.isOpen;
+}
+function restoreBackgroundElement({
+  element,
+  state
+}) {
+  element.inert = state.inert;
+  if (state.ariaHidden === null) {
+    element.removeAttribute('aria-hidden');
+  } else {
+    element.setAttribute('aria-hidden', state.ariaHidden);
+  }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/ModalAccessibility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["c","_c","useModal","useLayoutEffect","getActiveModal","ModalAccessibility","$","modalState","t0","t1","Object","values","some","_temp","restoredInert","Map","restore","element","wasInert","restoreBackgroundElement","state","clear","update","activeModal","background","Set","current","document","body","sibling","parentElement","children","HTMLElement","add","element_0","wasInert_0","has","delete","element_1","set","ariaHidden","getAttribute","inert","setAttribute","observer","MutationObserver","observe","attributeFilter","attributes","childList","subtree","disconnect","modal","isOpen","removeAttribute"],"sources":["../../../src/providers/ModalAccessibility/index.tsx"],"sourcesContent":["'use client'\n\nimport { useModal } from '@faceless-ui/modal'\nimport { useLayoutEffect } from 'react'\n\nimport { getActiveModal } from '../../utilities/getActiveModal.js'\n\n/** Keeps the page and lower modal layers out of navigation while the top modal is open. */\nexport function ModalAccessibility() {\n  const { modalState } = useModal()\n\n  useLayoutEffect(() => {\n    if (!Object.values(modalState).some((modal) => modal.isOpen)) {\n      return\n    }\n\n    const restoredInert = new Map<HTMLElement, BackgroundState>()\n\n    const restore = () => {\n      for (const [element, wasInert] of restoredInert) {\n        restoreBackgroundElement({ element, state: wasInert })\n      }\n      restoredInert.clear()\n    }\n\n    const update = () => {\n      const activeModal = getActiveModal({ modalState })\n\n      const background = new Set<HTMLElement>()\n      let current = activeModal\n\n      while (current && current !== document.body) {\n        for (const sibling of current.parentElement?.children ?? []) {\n          if (sibling !== current && sibling instanceof HTMLElement) {\n            background.add(sibling)\n          }\n        }\n        current = current.parentElement\n      }\n\n      for (const [element, wasInert] of restoredInert) {\n        if (!background.has(element)) {\n          restoreBackgroundElement({ element, state: wasInert })\n          restoredInert.delete(element)\n        }\n      }\n      for (const element of background) {\n        if (!restoredInert.has(element)) {\n          restoredInert.set(element, {\n            ariaHidden: element.getAttribute('aria-hidden'),\n            inert: element.inert,\n          })\n          element.inert = true\n          element.setAttribute('aria-hidden', 'true')\n        }\n      }\n    }\n\n    update()\n    // Drawers render asynchronously; also isolate siblings inserted after opening.\n    const observer = new MutationObserver(update)\n    observer.observe(document.body, {\n      attributeFilter: ['open'],\n      attributes: true,\n      childList: true,\n      subtree: true,\n    })\n\n    return () => {\n      observer.disconnect()\n      restore()\n    }\n  }, [modalState])\n\n  return null\n}\n\ntype BackgroundState = { ariaHidden: null | string; inert: boolean }\n\nfunction restoreBackgroundElement({\n  element,\n  state,\n}: {\n  element: HTMLElement\n  state: BackgroundState\n}) {\n  element.inert = state.inert\n  if (state.ariaHidden === null) {\n    element.removeAttribute('aria-hidden')\n  } else {\n    element.setAttribute('aria-hidden', state.ariaHidden)\n  }\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/providers/ModalFocus/index.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from 'react';
+type PopupRegistration = {
+    container: HTMLElement;
+    getTrigger: () => HTMLElement | null;
+};
+/** Captures popup ancestors before opening a modal can unmount its trigger. */
+export declare function ModalFocusProvider({ children }: {
+    children: ReactNode;
+}): import("react").JSX.Element;
+export declare const useModalFocus: () => {
+    getReturnFocusTargets: () => readonly HTMLElement[];
+    registerPopup: (registration: PopupRegistration) => () => void;
+};
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/ModalFocus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/ModalFocus/index.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,KAAK,iBAAiB,GAAG;IACvB,SAAS,EAAE,WAAW,CAAA;IACtB,UAAU,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;CACrC,CAAA;AAUD,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BA4DvE;AAED,eAAO,MAAM,aAAa;2BAtED,MAAM,SAAS,WAAW,EAAE;mBACpC,CAAC,YAAY,EAAE,iBAAiB,KAAK,MAAM,IAAI;CAqEP,CAAA"}

package/dist/providers/ModalFocus/index.js

@@ -0,0 +1,70 @@
+'use client';
+
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, use, useCallback, useLayoutEffect, useMemo, useRef } from 'react';
+const ModalFocusContext = /*#__PURE__*/createContext({
+  getReturnFocusTargets: () => [],
+  registerPopup: () => () => {}
+});
+/** Captures popup ancestors before opening a modal can unmount its trigger. */
+export function ModalFocusProvider({
+  children
+}) {
+  const targetsRef = useRef([]);
+  const popupsRef = useRef(new WeakMap());
+  const getReturnFocusTargets = useCallback(() => targetsRef.current, []);
+  const registerPopup = useCallback(({
+    container,
+    getTrigger
+  }) => {
+    popupsRef.current.set(container, getTrigger);
+    return () => {
+      popupsRef.current.delete(container);
+    };
+  }, []);
+  const context = useMemo(() => ({
+    getReturnFocusTargets,
+    registerPopup
+  }), [getReturnFocusTargets, registerPopup]);
+  useLayoutEffect(() => {
+    const rememberPopupTriggers = event => {
+      const opener = event?.target instanceof Element ? event.target : document.activeElement;
+      if (!opener || opener === document.body) {
+        return;
+      }
+      const targets = [];
+      let ancestor = opener;
+      while (ancestor) {
+        const getTrigger_0 = ancestor instanceof HTMLElement ? popupsRef.current.get(ancestor) : undefined;
+        if (getTrigger_0) {
+          // Pointer activation does not focus buttons in every browser.
+          if (!targets.length) {
+            const popupOpener = opener.closest('button, a[href], [tabindex]');
+            if (popupOpener) {
+              targets.push(popupOpener);
+            }
+          }
+          const trigger = getTrigger_0();
+          if (trigger && !targets.includes(trigger)) {
+            targets.push(trigger);
+          }
+        }
+        ancestor = ancestor.parentElement;
+      }
+      targetsRef.current = targets;
+    };
+    rememberPopupTriggers();
+    document.addEventListener('focusin', rememberPopupTriggers);
+    document.addEventListener('pointerdown', rememberPopupTriggers, true);
+    return () => {
+      document.removeEventListener('focusin', rememberPopupTriggers);
+      document.removeEventListener('pointerdown', rememberPopupTriggers, true);
+    };
+  }, []);
+  return /*#__PURE__*/_jsx(ModalFocusContext, {
+    value: context,
+    children: children
+  });
+}
+export const useModalFocus = () => use(ModalFocusContext);
+//# sourceMappingURL=index.js.map

package/dist/providers/ModalFocus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["createContext","use","useCallback","useLayoutEffect","useMemo","useRef","ModalFocusContext","getReturnFocusTargets","registerPopup","ModalFocusProvider","children","targetsRef","popupsRef","WeakMap","current","container","getTrigger","set","delete","context","rememberPopupTriggers","event","opener","target","Element","document","activeElement","body","targets","ancestor","HTMLElement","get","undefined","length","popupOpener","closest","push","trigger","includes","parentElement","addEventListener","removeEventListener","_jsx","value","useModalFocus"],"sources":["../../../src/providers/ModalFocus/index.tsx"],"sourcesContent":["'use client'\n\nimport type { ReactNode } from 'react'\n\nimport { createContext, use, useCallback, useLayoutEffect, useMemo, useRef } from 'react'\n\ntype PopupRegistration = {\n  container: HTMLElement\n  getTrigger: () => HTMLElement | null\n}\n\nconst ModalFocusContext = createContext<{\n  getReturnFocusTargets: () => readonly HTMLElement[]\n  registerPopup: (registration: PopupRegistration) => () => void\n}>({\n  getReturnFocusTargets: () => [],\n  registerPopup: () => () => {},\n})\n\n/** Captures popup ancestors before opening a modal can unmount its trigger. */\nexport function ModalFocusProvider({ children }: { children: ReactNode }) {\n  const targetsRef = useRef<readonly HTMLElement[]>([])\n  const popupsRef = useRef(new WeakMap<HTMLElement, PopupRegistration['getTrigger']>())\n  const getReturnFocusTargets = useCallback(() => targetsRef.current, [])\n  const registerPopup = useCallback(({ container, getTrigger }: PopupRegistration) => {\n    popupsRef.current.set(container, getTrigger)\n    return () => {\n      popupsRef.current.delete(container)\n    }\n  }, [])\n  const context = useMemo(\n    () => ({ getReturnFocusTargets, registerPopup }),\n    [getReturnFocusTargets, registerPopup],\n  )\n\n  useLayoutEffect(() => {\n    const rememberPopupTriggers = (event?: Event) => {\n      const opener = event?.target instanceof Element ? event.target : document.activeElement\n\n      if (!opener || opener === document.body) {\n        return\n      }\n\n      const targets: HTMLElement[] = []\n      let ancestor: Element | null = opener\n\n      while (ancestor) {\n        const getTrigger =\n          ancestor instanceof HTMLElement ? popupsRef.current.get(ancestor) : undefined\n\n        if (getTrigger) {\n          // Pointer activation does not focus buttons in every browser.\n          if (!targets.length) {\n            const popupOpener = opener.closest<HTMLElement>('button, a[href], [tabindex]')\n\n            if (popupOpener) {\n              targets.push(popupOpener)\n            }\n          }\n          const trigger = getTrigger()\n\n          if (trigger && !targets.includes(trigger)) {\n            targets.push(trigger)\n          }\n        }\n        ancestor = ancestor.parentElement\n      }\n      targetsRef.current = targets\n    }\n\n    rememberPopupTriggers()\n    document.addEventListener('focusin', rememberPopupTriggers)\n    document.addEventListener('pointerdown', rememberPopupTriggers, true)\n    return () => {\n      document.removeEventListener('focusin', rememberPopupTriggers)\n      document.removeEventListener('pointerdown', rememberPopupTriggers, true)\n    }\n  }, [])\n\n  return <ModalFocusContext value={context}>{children}</ModalFocusContext>\n}\n\nexport const useModalFocus = () => use(ModalFocusContext)\n"],"mappings":"AAAA;;;AAIA,SAASA,aAAa,EAAEC,GAAG,EAAEC,WAAW,EAAEC,eAAe,EAAEC,OAAO,EAAEC,MAAM,QAAQ;AAOlF,MAAMC,iBAAA,gBAAoBN,aAAA,CAGvB;EACDO,qBAAA,EAAuBA,CAAA,KAAM,EAAE;EAC/BC,aAAA,EAAeA,CAAA,KAAM,OAAO;AAC9B;AAEA;AACA,OAAO,SAASC,mBAAmB;EAAEC;AAAQ,CAA2B;EACtE,MAAMC,UAAA,GAAaN,MAAA,CAA+B,EAAE;EACpD,MAAMO,SAAA,GAAYP,MAAA,CAAO,IAAIQ,OAAA;EAC7B,MAAMN,qBAAA,GAAwBL,WAAA,CAAY,MAAMS,UAAA,CAAWG,OAAO,EAAE,EAAE;EACtE,MAAMN,aAAA,GAAgBN,WAAA,CAAY,CAAC;IAAEa,SAAS;IAAEC;EAAU,CAAqB;IAC7EJ,SAAA,CAAUE,OAAO,CAACG,GAAG,CAACF,SAAA,EAAWC,UAAA;IACjC,OAAO;MACLJ,SAAA,CAAUE,OAAO,CAACI,MAAM,CAACH,SAAA;IAC3B;EACF,GAAG,EAAE;EACL,MAAMI,OAAA,GAAUf,OAAA,CACd,OAAO;IAAEG,qBAAA;IAAuBC;EAAc,IAC9C,CAACD,qBAAA,EAAuBC,aAAA,CAAc;EAGxCL,eAAA,CAAgB;IACd,MAAMiB,qBAAA,GAAyBC,KAAA;MAC7B,MAAMC,MAAA,GAASD,KAAA,EAAOE,MAAA,YAAkBC,OAAA,GAAUH,KAAA,CAAME,MAAM,GAAGE,QAAA,CAASC,aAAa;MAEvF,IAAI,CAACJ,MAAA,IAAUA,MAAA,KAAWG,QAAA,CAASE,IAAI,EAAE;QACvC;MACF;MAEA,MAAMC,OAAA,GAAyB,EAAE;MACjC,IAAIC,QAAA,GAA2BP,MAAA;MAE/B,OAAOO,QAAA,EAAU;QACf,MAAMb,YAAA,GACJa,QAAA,YAAoBC,WAAA,GAAclB,SAAA,CAAUE,OAAO,CAACiB,GAAG,CAACF,QAAA,IAAYG,SAAA;QAEtE,IAAIhB,YAAA,EAAY;UACd;UACA,IAAI,CAACY,OAAA,CAAQK,MAAM,EAAE;YACnB,MAAMC,WAAA,GAAcZ,MAAA,CAAOa,OAAO,CAAc;YAEhD,IAAID,WAAA,EAAa;cACfN,OAAA,CAAQQ,IAAI,CAACF,WAAA;YACf;UACF;UACA,MAAMG,OAAA,GAAUrB,YAAA;UAEhB,IAAIqB,OAAA,IAAW,CAACT,OAAA,CAAQU,QAAQ,CAACD,OAAA,GAAU;YACzCT,OAAA,CAAQQ,IAAI,CAACC,OAAA;UACf;QACF;QACAR,QAAA,GAAWA,QAAA,CAASU,aAAa;MACnC;MACA5B,UAAA,CAAWG,OAAO,GAAGc,OAAA;IACvB;IAEAR,qBAAA;IACAK,QAAA,CAASe,gBAAgB,CAAC,WAAWpB,qBAAA;IACrCK,QAAA,CAASe,gBAAgB,CAAC,eAAepB,qBAAA,EAAuB;IAChE,OAAO;MACLK,QAAA,CAASgB,mBAAmB,CAAC,WAAWrB,qBAAA;MACxCK,QAAA,CAASgB,mBAAmB,CAAC,eAAerB,qBAAA,EAAuB;IACrE;EACF,GAAG,EAAE;EAEL,oBAAOsB,IAAA,CAACpC,iBAAA;IAAkBqC,KAAA,EAAOxB,OAAA;cAAUT;;AAC7C;AAEA,OAAO,MAAMkC,aAAA,GAAgBA,CAAA,KAAM3C,GAAA,CAAIK,iBAAA","ignoreList":[]}

package/dist/providers/Preferences/index.d.ts

@@ -1,13 +1,21 @@
 import React from 'react';
 import type { Preferences } from '../../forms/Form/types.js';
+type PreferenceUpdater<T> = (current: null | T) => T;
+type SetPreference = {
+    <T = Preferences>(key: string, updater: PreferenceUpdater<T>): Promise<void>;
+    <T = Preferences>(key: string, value: T, merge?: boolean): Promise<void>;
+};
 type PreferencesContext = {
     getPreference: <T = Preferences>(key: string) => Promise<T>;
     /**
      * @param key - a string identifier for the property being set
      * @param value - preference data to store
-     * @param merge - when true will combine the existing preference object batch the change into one request for objects, default = false
+     * @param merge - when true, combines the value with the existing preference stored under the key
+     * and batches concurrent changes to that key into one request, default = false. Awaiting the
+     * returned promise waits for the write to land either way.
      */
-    setPreference: <T = Preferences>(key: string, value: T, merge?: boolean) => Promise<void>;
+    setPreference: SetPreference;
+    syncPreference: <T = Preferences>(key: string, value: T) => void;
 };
 export declare const PreferencesProvider: React.FC<{
     children?: React.ReactNode;

package/dist/providers/Preferences/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/Preferences/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA6D,MAAM,OAAO,CAAA;AAEjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAQ5D,KAAK,kBAAkB,GAAG;IACxB,aAAa,EAAE,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAC3D;;;;OAIG;IACH,aAAa,EAAE,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1F,CAAA;AAYD,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CA6IxE,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,kBAAkC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/providers/Preferences/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAA6D,MAAM,OAAO,CAAA;AAEjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAQ5D,KAAK,iBAAiB,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;AAEpD,KAAK,aAAa,GAAG;IACnB,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5E,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzE,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,aAAa,EAAE,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IAC3D;;;;;;OAMG;IACH,aAAa,EAAE,aAAa,CAAA;IAC5B,cAAc,EAAE,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;CACjE,CAAA;AAYD,eAAO,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAmOxE,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,kBAAkC,CAAA"}