@strapi/upload 5.51.2 → 5.52.1

package/dist/admin/future/pages/Assets/hooks/useInfiniteAssets.mjs

@@ -1,90 +1,230 @@
-import { useState, useRef, useMemo, useEffect, useCallback } from 'react';
+import { useState, useCallback, createElement, Fragment, useRef, useEffect, useMemo } from 'react';
+import { useDispatch, useStore } from 'react-redux';
+import { uploadApi } from '../../../services/api.mjs';
 import { useGetAssetsQuery } from '../../../services/assets.mjs';
 
 const PAGE_SIZE = 20;
-const useInfiniteAssets = ({ folder = null, sort, search, filters, filtersKey = '', enabled = true } = {})=>{
-    const [page, setPage] = useState(1);
-    const lastResultsRef = useRef([]);
-    const lastPaginationRef = useRef(undefined);
-    const isMountRef = useRef(true);
-    const isSearchMountRef = useRef(true);
-    const { currentData: data, isLoading, isFetching, error } = useGetAssetsQuery({
-        folder,
+/**
+ * Concatenates the pages in ascending order, one entry per asset id.
+ *
+ * `Map.set` keeps the first insertion position but takes the latest value, so
+ * an asset that moved between pages after a mutation holds its place and shows
+ * fresh data instead of rendering twice under a duplicate key.
+ */ const flattenPages = (pages)=>{
+    const byId = new Map();
+    for (const page of Object.keys(pages).map(Number).sort((a, b)=>a - b)){
+        for (const asset of pages[page]){
+            byId.set(asset.id, asset);
+        }
+    }
+    return [
+        ...byId.values()
+    ];
+};
+/**
+ * Keeps one earlier page's `getAssets` query subscribed and reports its results
+ * back up whenever they change.
+ *
+ * The hook itself only subscribes the current (latest) page. Without these, a
+ * mutation invalidating `{Asset, LIST}` refetches that page alone and earlier
+ * pages stay frozen — a rename or delete on an earlier page never reaches the
+ * list until a folder/sort/search change. One subscriber per earlier
+ * page keeps them all subscribed so the invalidation refetches the whole list.
+ * Renders nothing; it exists only for the subscription + `onRefreshed` report.
+ */ const PageSubscriber = ({ queryArgs, page, onRefreshed })=>{
+    const { currentData } = useGetAssetsQuery({
+        ...queryArgs,
+        page,
+        pageSize: PAGE_SIZE
+    });
+    const results = currentData?.results;
+    useEffect(()=>{
+        if (results) {
+            onRefreshed(page, results);
+        }
+    // `results` is a stable reference per cache entry, so this only re-reports
+    // when a refetch actually replaces the page's data. Reporting the same
+    // reference the accumulator already holds is a no-op (see `onRefreshed`).
+    }, [
+        results,
         page,
-        pageSize: PAGE_SIZE,
+        onRefreshed
+    ]);
+    return null;
+};
+/**
+ * Infinite scroll over `/upload/files`, keeping one accumulated slot per page.
+ *
+ * The caller MUST render the returned `subscribers` node — that is what keeps
+ * every loaded page subscribed, so `{Asset, LIST}` invalidations keep the whole
+ * list consistent rather than only the current page.
+ */ const useInfiniteAssets = ({ folder = null, sort, search, filters, enabled = true } = {})=>{
+    // Derived from the request args themselves, so a new filter can't reach the
+    // API without also invalidating what was accumulated under the old one.
+    const queryArgs = {
+        folder,
         sort,
         search,
         filters
+    };
+    const queryKey = JSON.stringify(queryArgs);
+    // Identifies the list being viewed, ignoring the search term. Folder, sort
+    // and filter changes are single committed actions, so one clean reset per
+    // change is honest. Search is committed per keystroke on a 300ms debounce,
+    // and blanking the list on each one would strobe as the user types.
+    // The cost: through the search window the previous rows stay rendered and
+    // `hasNextPage` is false, so the list reads as complete until page 1 lands.
+    const listKey = JSON.stringify({
+        folder,
+        sort,
+        filters
+    });
+    const [pageState, setPageState] = useState({
+        queryKey,
+        page: 1
+    });
+    const [accumulated, setAccumulated] = useState({
+        queryKey,
+        listKey,
+        pages: {}
+    });
+    // Derived rather than read straight from state: the render that discovers
+    // the key change still reaches the query below, and a list with no page 1
+    // must never be requested at page 2.
+    const page = pageState.queryKey === queryKey ? pageState.page : 1;
+    if (pageState.queryKey !== queryKey) {
+        setPageState({
+            queryKey,
+            page: 1
+        });
+    }
+    const { currentData, isLoading, isFetching, error } = useGetAssetsQuery({
+        ...queryArgs,
+        page,
+        pageSize: PAGE_SIZE
     }, {
         skip: !enabled
     });
-    const pagination = data?.pagination;
-    if (pagination) {
-        lastPaginationRef.current = pagination;
+    const isSameQuery = accumulated.queryKey === queryKey;
+    // `currentData` is only ever the payload for the args just passed, so it
+    // belongs to this key at this page — nothing to infer. Its reference is
+    // stable per cache entry, so this settles after one extra render.
+    if (currentData && (!isSameQuery || accumulated.pages[page] !== currentData.results)) {
+        setAccumulated(isSameQuery ? {
+            ...accumulated,
+            pages: {
+                ...accumulated.pages,
+                [page]: currentData.results
+            },
+            pagination: currentData.pagination
+        } : {
+            queryKey,
+            listKey,
+            pages: {
+                [page]: currentData.results
+            },
+            pagination: currentData.pagination
+        });
     }
-    // Accumulate pages. When cache is invalidated the current page is refetched
-    // detect this and reset to avoid a gap in the results.
-    const assets = useMemo(()=>{
-        if (!data) {
-            return lastResultsRef.current;
-        }
-        const currentPageResults = data.results;
-        if (page === 1) {
-            lastResultsRef.current = currentPageResults;
-        } else {
-            // If accumulated length doesn't match expectation, cache was cleared
-            const expectedPrior = (page - 1) * PAGE_SIZE;
-            if (lastResultsRef.current.length < expectedPrior - PAGE_SIZE) {
-                return lastResultsRef.current;
+    // Merges a refetched earlier page back into the accumulator. Ignores reports
+    // for a superseded query, and no-ops when the reference is unchanged so a
+    // subscriber re-reporting its already-stored page can't loop.
+    const handlePageRefreshed = useCallback((refreshedPage, results)=>{
+        setAccumulated((prev)=>{
+            if (prev.queryKey !== queryKey || prev.pages[refreshedPage] === results) {
+                return prev;
             }
-            // Only append if these aren't already accumulated
-            if (lastResultsRef.current.length < page * PAGE_SIZE) {
-                lastResultsRef.current = [
-                    ...lastResultsRef.current,
-                    ...currentPageResults
-                ];
-            }
-        }
-        return lastResultsRef.current;
+            return {
+                ...prev,
+                pages: {
+                    ...prev.pages,
+                    [refreshedPage]: results
+                }
+            };
+        });
     }, [
-        data,
-        page
+        queryKey
     ]);
-    // Reset on filter/sort change — skip the initial mount since the memo
-    // already handles page 1 correctly
+    // One subscriber per earlier page (the current page is already subscribed by
+    // the query above). Keyed by queryKey so a folder/sort/search change remounts
+    // them against the new args instead of reusing a stale cache entry.
+    // `createElement` rather than JSX so this stays a plain `.ts` hook file.
+    const subscribers = createElement(Fragment, null, Array.from({
+        length: Math.max(0, page - 1)
+    }, (_, index)=>index + 1).map((earlierPage)=>createElement(PageSubscriber, {
+            key: `${queryKey}:${earlierPage}`,
+            queryArgs,
+            page: earlierPage,
+            onRefreshed: handlePageRefreshed
+        })));
+    // Drop the left folder's cached `getAssets` pages when the folder changes.
+    //
+    // RTK Query 1.9.7 leaves a query's store subscription in place when its last
+    // subscriber unmounts while a refetch is still in flight — e.g. a delete
+    // invalidates `{Asset, LIST}`, every loaded page starts refetching, and the
+    // user navigates away before those settle. Those stale subscriptions make the
+    // next `{Asset, LIST}` invalidation (an upload in the new folder) refetch the
+    // *previous* folder's pages: one bogus `/upload/files` request per loaded
+    // page. There is no public per-entry unsubscribe, so evict the left folder's
+    // entries outright — returning reloads from page 1, which the accumulator
+    // already does on a list change.
+    const dispatch = useDispatch();
+    const store = useStore();
+    const prevFolderRef = useRef(folder);
     useEffect(()=>{
-        if (isMountRef.current) {
-            isMountRef.current = false;
+        const prevFolder = prevFolderRef.current;
+        prevFolderRef.current = folder;
+        if (prevFolder === folder) {
             return;
         }
-        setPage(1);
-        lastResultsRef.current = [];
+        const apiState = store.getState()[uploadApi.reducerPath];
+        const removeQueryResult = uploadApi.internalActions.removeQueryResult;
+        Object.keys(apiState?.queries ?? {}).forEach((cacheKey)=>{
+            if (!cacheKey.startsWith('getAssets(')) {
+                return;
+            }
+            let args;
+            try {
+                args = JSON.parse(cacheKey.slice('getAssets('.length, -1));
+            } catch  {
+                return;
+            }
+            if (args.folder === prevFolder) {
+                dispatch(removeQueryResult({
+                    queryCacheKey: cacheKey
+                }));
+            }
+        });
     }, [
         folder,
-        sort,
-        filtersKey
+        dispatch,
+        store
     ]);
-    // A search change resets pagination but keeps the previous results rendered
-    // until the new page 1 lands, which replaces them.
-    useEffect(()=>{
-        if (isSearchMountRef.current) {
-            isSearchMountRef.current = false;
-            return;
-        }
-        setPage(1);
-    }, [
-        search
+    // Until the new list's first page lands the accumulator still holds the
+    // previous folder. Reported as loading so the page shows a spinner instead
+    // of the outgoing folder's assets under the incoming folder's header.
+    const isChangingList = accumulated.listKey !== listKey;
+    const assets = useMemo(()=>isChangingList ? [] : flattenPages(accumulated.pages), [
+        isChangingList,
+        accumulated.pages
     ]);
     // Deliberately the live value, not the stale-tolerant one below: paging must
     // never be driven by a total that belongs to the previous query.
-    const hasNextPage = pagination ? page < pagination.pageCount : false;
+    const hasNextPage = currentData ? page < currentData.pagination.pageCount : false;
     const isFetchingMore = isFetching && page > 1;
     const fetchNextPage = useCallback(()=>{
-        setPage((prev)=>prev + 1);
-    }, []);
+        setPageState((prev)=>({
+                queryKey,
+                page: (prev.queryKey === queryKey ? prev.page : 1) + 1
+            }));
+    }, [
+        queryKey
+    ]);
     if (!enabled) {
         return {
             assets: [],
+            // No list to keep fresh while disabled, so nothing to subscribe.
+            subscribers: null,
             pagination: undefined,
             isLoading: false,
             isFetchingMore: false,
@@ -95,10 +235,11 @@ const useInfiniteAssets = ({ folder = null, sort, search, filters, filtersKey =
     }
     return {
         assets,
-        // Reported alongside the stale `assets` above so a consumer showing the total
-        // doesn't flash zero mid-transition.
-        pagination: pagination ?? lastPaginationRef.current,
-        isLoading,
+        subscribers,
+        // Falls back to the accumulated total so a consumer showing the count
+        // doesn't flash zero mid-transition, matching the possibly stale `assets`.
+        pagination: currentData?.pagination ?? accumulated.pagination,
+        isLoading: isLoading || isChangingList,
         isFetchingMore,
         hasNextPage,
         fetchNextPage,

package/dist/admin/future/pages/Assets/hooks/useInfiniteAssets.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"useInfiniteAssets.mjs","sources":["../../../../../../admin/src/future/pages/Assets/hooks/useInfiniteAssets.ts"],"sourcesContent":["import { useState, useCallback, useMemo, useEffect, useRef } from 'react';\n\nimport { useGetAssetsQuery } from '../../../services/assets';\n\nimport type { File, Pagination } from '../../../../../../shared/contracts/files';\n\nconst PAGE_SIZE = 20;\n\ninterface UseInfiniteAssetsOptions {\n  folder?: number | null;\n  sort?: string;\n  search?: string;\n  /** Extra `filters[$and]` entries for the files query. */\n  filters?: Record<string, unknown>[];\n  /**\n   * Stable fingerprint of `filters` — a change resets the accumulated pages\n   * (the array identity itself changes every render).\n   */\n  filtersKey?: string;\n  /** Structural switch: an `is [folder]`-only type badge means no file can match. */\n  enabled?: boolean;\n}\n\nconst useInfiniteAssets = ({\n  folder = null,\n  sort,\n  search,\n  filters,\n  filtersKey = '',\n  enabled = true,\n}: UseInfiniteAssetsOptions = {}) => {\n  const [page, setPage] = useState(1);\n  const lastResultsRef = useRef<File[]>([]);\n  const lastPaginationRef = useRef<Pagination | undefined>(undefined);\n  const isMountRef = useRef(true);\n  const isSearchMountRef = useRef(true);\n\n  const {\n    currentData: data,\n    isLoading,\n    isFetching,\n    error,\n  } = useGetAssetsQuery(\n    {\n      folder,\n      page,\n      pageSize: PAGE_SIZE,\n      sort,\n      search,\n      filters,\n    },\n    { skip: !enabled }\n  );\n\n  const pagination = data?.pagination;\n\n  if (pagination) {\n    lastPaginationRef.current = pagination;\n  }\n\n  // Accumulate pages. When cache is invalidated the current page is refetched\n  // detect this and reset to avoid a gap in the results.\n  const assets = useMemo(() => {\n    if (!data) {\n      return lastResultsRef.current;\n    }\n\n    const currentPageResults = data.results;\n\n    if (page === 1) {\n      lastResultsRef.current = currentPageResults;\n    } else {\n      // If accumulated length doesn't match expectation, cache was cleared\n      const expectedPrior = (page - 1) * PAGE_SIZE;\n      if (lastResultsRef.current.length < expectedPrior - PAGE_SIZE) {\n        return lastResultsRef.current;\n      }\n\n      // Only append if these aren't already accumulated\n      if (lastResultsRef.current.length < page * PAGE_SIZE) {\n        lastResultsRef.current = [...lastResultsRef.current, ...currentPageResults];\n      }\n    }\n\n    return lastResultsRef.current;\n  }, [data, page]);\n\n  // Reset on filter/sort change — skip the initial mount since the memo\n  // already handles page 1 correctly\n  useEffect(() => {\n    if (isMountRef.current) {\n      isMountRef.current = false;\n\n      return;\n    }\n    setPage(1);\n    lastResultsRef.current = [];\n  }, [folder, sort, filtersKey]);\n\n  // A search change resets pagination but keeps the previous results rendered\n  // until the new page 1 lands, which replaces them.\n  useEffect(() => {\n    if (isSearchMountRef.current) {\n      isSearchMountRef.current = false;\n\n      return;\n    }\n    setPage(1);\n  }, [search]);\n\n  // Deliberately the live value, not the stale-tolerant one below: paging must\n  // never be driven by a total that belongs to the previous query.\n  const hasNextPage = pagination ? page < pagination.pageCount : false;\n  const isFetchingMore = isFetching && page > 1;\n\n  const fetchNextPage = useCallback(() => {\n    setPage((prev) => prev + 1);\n  }, []);\n\n  if (!enabled) {\n    return {\n      assets: [] as File[],\n      pagination: undefined,\n      isLoading: false,\n      isFetchingMore: false,\n      hasNextPage: false,\n      fetchNextPage,\n      error: undefined,\n    };\n  }\n\n  return {\n    assets,\n    // Reported alongside the stale `assets` above so a consumer showing the total\n    // doesn't flash zero mid-transition.\n    pagination: pagination ?? lastPaginationRef.current,\n    isLoading,\n    isFetchingMore,\n    hasNextPage,\n    fetchNextPage,\n    error,\n  };\n};\n\nexport { useInfiniteAssets };\nexport { PAGE_SIZE };\n"],"names":["PAGE_SIZE","useInfiniteAssets","folder","sort","search","filters","filtersKey","enabled","page","setPage","useState","lastResultsRef","useRef","lastPaginationRef","undefined","isMountRef","isSearchMountRef","currentData","data","isLoading","isFetching","error","useGetAssetsQuery","pageSize","skip","pagination","current","assets","useMemo","currentPageResults","results","expectedPrior","length","useEffect","hasNextPage","pageCount","isFetchingMore","fetchNextPage","useCallback","prev"],"mappings":"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"}
+{"version":3,"file":"useInfiniteAssets.mjs","sources":["../../../../../../admin/src/future/pages/Assets/hooks/useInfiniteAssets.ts"],"sourcesContent":["import { createElement, Fragment, useCallback, useEffect, useMemo, useRef, useState } from 'react';\n\nimport { useDispatch, useStore } from 'react-redux';\n\nimport { uploadApi } from '../../../services/api';\nimport { useGetAssetsQuery } from '../../../services/assets';\n\nimport type { File, Pagination } from '../../../../../../shared/contracts/files';\n\nconst PAGE_SIZE = 20;\n\ninterface UseInfiniteAssetsOptions {\n  folder?: number | null;\n  sort?: string;\n  search?: string;\n  /** Extra `filters[$and]` entries for the files query. */\n  filters?: Record<string, unknown>[];\n  /** Structural switch: an `is [folder]`-only type badge means no file can match. */\n  enabled?: boolean;\n}\n\ninterface QueryArgs {\n  folder: number | null;\n  sort?: string;\n  search?: string;\n  filters?: Record<string, unknown>[];\n}\n\n/**\n * Everything loaded for one query identity.\n *\n * `queryKey` lags the live key while a new query is in flight — that lag is\n * what keeps the previous results on screen across a search change.\n */\ninterface Accumulated {\n  queryKey: string;\n  listKey: string;\n  pages: Record<number, File[]>;\n  pagination?: Pagination;\n}\n\ninterface PageState {\n  queryKey: string;\n  page: number;\n}\n\ntype PageRefreshedHandler = (page: number, results: File[]) => void;\n\n/**\n * Concatenates the pages in ascending order, one entry per asset id.\n *\n * `Map.set` keeps the first insertion position but takes the latest value, so\n * an asset that moved between pages after a mutation holds its place and shows\n * fresh data instead of rendering twice under a duplicate key.\n */\nconst flattenPages = (pages: Record<number, File[]>): File[] => {\n  const byId = new Map<number, File>();\n\n  for (const page of Object.keys(pages)\n    .map(Number)\n    .sort((a, b) => a - b)) {\n    for (const asset of pages[page]) {\n      byId.set(asset.id, asset);\n    }\n  }\n\n  return [...byId.values()];\n};\n\n/**\n * Keeps one earlier page's `getAssets` query subscribed and reports its results\n * back up whenever they change.\n *\n * The hook itself only subscribes the current (latest) page. Without these, a\n * mutation invalidating `{Asset, LIST}` refetches that page alone and earlier\n * pages stay frozen — a rename or delete on an earlier page never reaches the\n * list until a folder/sort/search change. One subscriber per earlier\n * page keeps them all subscribed so the invalidation refetches the whole list.\n * Renders nothing; it exists only for the subscription + `onRefreshed` report.\n */\nconst PageSubscriber = ({\n  queryArgs,\n  page,\n  onRefreshed,\n}: {\n  queryArgs: QueryArgs;\n  page: number;\n  onRefreshed: PageRefreshedHandler;\n}) => {\n  const { currentData } = useGetAssetsQuery({ ...queryArgs, page, pageSize: PAGE_SIZE });\n  const results = currentData?.results;\n\n  useEffect(() => {\n    if (results) {\n      onRefreshed(page, results);\n    }\n    // `results` is a stable reference per cache entry, so this only re-reports\n    // when a refetch actually replaces the page's data. Reporting the same\n    // reference the accumulator already holds is a no-op (see `onRefreshed`).\n  }, [results, page, onRefreshed]);\n\n  return null;\n};\n\n/**\n * Infinite scroll over `/upload/files`, keeping one accumulated slot per page.\n *\n * The caller MUST render the returned `subscribers` node — that is what keeps\n * every loaded page subscribed, so `{Asset, LIST}` invalidations keep the whole\n * list consistent rather than only the current page.\n */\nconst useInfiniteAssets = ({\n  folder = null,\n  sort,\n  search,\n  filters,\n  enabled = true,\n}: UseInfiniteAssetsOptions = {}) => {\n  // Derived from the request args themselves, so a new filter can't reach the\n  // API without also invalidating what was accumulated under the old one.\n  const queryArgs: QueryArgs = { folder, sort, search, filters };\n  const queryKey = JSON.stringify(queryArgs);\n  // Identifies the list being viewed, ignoring the search term. Folder, sort\n  // and filter changes are single committed actions, so one clean reset per\n  // change is honest. Search is committed per keystroke on a 300ms debounce,\n  // and blanking the list on each one would strobe as the user types.\n  // The cost: through the search window the previous rows stay rendered and\n  // `hasNextPage` is false, so the list reads as complete until page 1 lands.\n  const listKey = JSON.stringify({ folder, sort, filters });\n\n  const [pageState, setPageState] = useState<PageState>({ queryKey, page: 1 });\n  const [accumulated, setAccumulated] = useState<Accumulated>({ queryKey, listKey, pages: {} });\n\n  // Derived rather than read straight from state: the render that discovers\n  // the key change still reaches the query below, and a list with no page 1\n  // must never be requested at page 2.\n  const page = pageState.queryKey === queryKey ? pageState.page : 1;\n\n  if (pageState.queryKey !== queryKey) {\n    setPageState({ queryKey, page: 1 });\n  }\n\n  const { currentData, isLoading, isFetching, error } = useGetAssetsQuery(\n    {\n      ...queryArgs,\n      page,\n      pageSize: PAGE_SIZE,\n    },\n    { skip: !enabled }\n  );\n\n  const isSameQuery = accumulated.queryKey === queryKey;\n\n  // `currentData` is only ever the payload for the args just passed, so it\n  // belongs to this key at this page — nothing to infer. Its reference is\n  // stable per cache entry, so this settles after one extra render.\n  if (currentData && (!isSameQuery || accumulated.pages[page] !== currentData.results)) {\n    setAccumulated(\n      isSameQuery\n        ? {\n            ...accumulated,\n            pages: { ...accumulated.pages, [page]: currentData.results },\n            pagination: currentData.pagination,\n          }\n        : {\n            queryKey,\n            listKey,\n            pages: { [page]: currentData.results },\n            pagination: currentData.pagination,\n          }\n    );\n  }\n\n  // Merges a refetched earlier page back into the accumulator. Ignores reports\n  // for a superseded query, and no-ops when the reference is unchanged so a\n  // subscriber re-reporting its already-stored page can't loop.\n  const handlePageRefreshed = useCallback<PageRefreshedHandler>(\n    (refreshedPage, results) => {\n      setAccumulated((prev) => {\n        if (prev.queryKey !== queryKey || prev.pages[refreshedPage] === results) {\n          return prev;\n        }\n\n        return { ...prev, pages: { ...prev.pages, [refreshedPage]: results } };\n      });\n    },\n    [queryKey]\n  );\n\n  // One subscriber per earlier page (the current page is already subscribed by\n  // the query above). Keyed by queryKey so a folder/sort/search change remounts\n  // them against the new args instead of reusing a stale cache entry.\n  // `createElement` rather than JSX so this stays a plain `.ts` hook file.\n  const subscribers = createElement(\n    Fragment,\n    null,\n    Array.from({ length: Math.max(0, page - 1) }, (_, index) => index + 1).map((earlierPage) =>\n      createElement(PageSubscriber, {\n        key: `${queryKey}:${earlierPage}`,\n        queryArgs,\n        page: earlierPage,\n        onRefreshed: handlePageRefreshed,\n      })\n    )\n  );\n\n  // Drop the left folder's cached `getAssets` pages when the folder changes.\n  //\n  // RTK Query 1.9.7 leaves a query's store subscription in place when its last\n  // subscriber unmounts while a refetch is still in flight — e.g. a delete\n  // invalidates `{Asset, LIST}`, every loaded page starts refetching, and the\n  // user navigates away before those settle. Those stale subscriptions make the\n  // next `{Asset, LIST}` invalidation (an upload in the new folder) refetch the\n  // *previous* folder's pages: one bogus `/upload/files` request per loaded\n  // page. There is no public per-entry unsubscribe, so evict the left folder's\n  // entries outright — returning reloads from page 1, which the accumulator\n  // already does on a list change.\n  const dispatch = useDispatch();\n  const store = useStore();\n  const prevFolderRef = useRef(folder);\n  useEffect(() => {\n    const prevFolder = prevFolderRef.current;\n    prevFolderRef.current = folder;\n    if (prevFolder === folder) {\n      return;\n    }\n\n    const apiState = (store.getState() as Record<string, { queries?: Record<string, unknown> }>)[\n      uploadApi.reducerPath\n    ];\n    const removeQueryResult = (\n      uploadApi as unknown as {\n        internalActions: {\n          removeQueryResult: (payload: { queryCacheKey: string }) => { type: string };\n        };\n      }\n    ).internalActions.removeQueryResult;\n\n    Object.keys(apiState?.queries ?? {}).forEach((cacheKey) => {\n      if (!cacheKey.startsWith('getAssets(')) {\n        return;\n      }\n      let args: { folder?: number | null };\n      try {\n        args = JSON.parse(cacheKey.slice('getAssets('.length, -1));\n      } catch {\n        return;\n      }\n      if (args.folder === prevFolder) {\n        dispatch(removeQueryResult({ queryCacheKey: cacheKey }));\n      }\n    });\n  }, [folder, dispatch, store]);\n\n  // Until the new list's first page lands the accumulator still holds the\n  // previous folder. Reported as loading so the page shows a spinner instead\n  // of the outgoing folder's assets under the incoming folder's header.\n  const isChangingList = accumulated.listKey !== listKey;\n\n  const assets = useMemo(\n    () => (isChangingList ? [] : flattenPages(accumulated.pages)),\n    [isChangingList, accumulated.pages]\n  );\n\n  // Deliberately the live value, not the stale-tolerant one below: paging must\n  // never be driven by a total that belongs to the previous query.\n  const hasNextPage = currentData ? page < currentData.pagination.pageCount : false;\n  const isFetchingMore = isFetching && page > 1;\n\n  const fetchNextPage = useCallback(() => {\n    setPageState((prev) => ({\n      queryKey,\n      page: (prev.queryKey === queryKey ? prev.page : 1) + 1,\n    }));\n  }, [queryKey]);\n\n  if (!enabled) {\n    return {\n      assets: [] as File[],\n      // No list to keep fresh while disabled, so nothing to subscribe.\n      subscribers: null,\n      pagination: undefined,\n      isLoading: false,\n      isFetchingMore: false,\n      hasNextPage: false,\n      fetchNextPage,\n      error: undefined,\n    };\n  }\n\n  return {\n    assets,\n    subscribers,\n    // Falls back to the accumulated total so a consumer showing the count\n    // doesn't flash zero mid-transition, matching the possibly stale `assets`.\n    pagination: currentData?.pagination ?? accumulated.pagination,\n    isLoading: isLoading || isChangingList,\n    isFetchingMore,\n    hasNextPage,\n    fetchNextPage,\n    error,\n  };\n};\n\nexport { useInfiniteAssets };\nexport { PAGE_SIZE };\n"],"names":["PAGE_SIZE","flattenPages","pages","byId","Map","page","Object","keys","map","Number","sort","a","b","asset","set","id","values","PageSubscriber","queryArgs","onRefreshed","currentData","useGetAssetsQuery","pageSize","results","useEffect","useInfiniteAssets","folder","search","filters","enabled","queryKey","JSON","stringify","listKey","pageState","setPageState","useState","accumulated","setAccumulated","isLoading","isFetching","error","skip","isSameQuery","pagination","handlePageRefreshed","useCallback","refreshedPage","prev","subscribers","createElement","Fragment","Array","from","length","Math","max","_","index","earlierPage","key","dispatch","useDispatch","store","useStore","prevFolderRef","useRef","prevFolder","current","apiState","getState","uploadApi","reducerPath","removeQueryResult","internalActions","queries","forEach","cacheKey","startsWith","args","parse","slice","queryCacheKey","isChangingList","assets","useMemo","hasNextPage","pageCount","isFetchingMore","fetchNextPage","undefined"],"mappings":"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"}

package/dist/admin/future/pages/Assets/hooks/useInfiniteScrollSentinel.js

@@ -0,0 +1,75 @@
+'use strict';
+
+var React = require('react');
+
+/**
+ * Infinite-scroll trigger for the media library list.
+ *
+ * Returns a callback ref to place on a sentinel element rendered after the last
+ * row. Three deliberate choices:
+ *
+ * 1. **Loading is driven only by fresh observer readings.** A fetch fires from
+ *    the `IntersectionObserver` callback — never from a state/prop change — so
+ *    it can't react to a stale `isIntersecting` from before newly loaded rows
+ *    rendered (which fetched an extra page on every trigger).
+ *
+ * 2. **Each settled page re-observes the sentinel.** An `IntersectionObserver`
+ *    only fires on a *transition*. When the sentinel stays on screen (a page
+ *    that doesn't fill the viewport — tall viewport, short page, grid fitting
+ *    the whole page) it would never fire again and loading would stall. So when
+ *    `isFetchingMore` settles back to false we re-observe, forcing a fresh
+ *    reading against the new layout: still on screen → load the next page;
+ *    viewport now filled → stop.
+ *
+ * 3. **A callback ref, not a stable object ref.** The sentinel only mounts once
+ *    the first page has rendered (the list shows a loader before that). A
+ *    callback ref (re)binds the observer exactly when the node mounts/unmounts,
+ *    so the observer can't miss a sentinel that appears after the hook first ran.
+ */ const useInfiniteScrollSentinel = ({ hasNextPage, isFetchingMore, onLoadMore, options })=>{
+    const observerRef = React.useRef(null);
+    const nodeRef = React.useRef(null);
+    // Read through refs so the callback ref stays stable and the observer callback
+    // always sees the latest values. `options` is read once at attach time (see
+    // its JSDoc); `onLoadMore` need not be stable.
+    const optionsRef = React.useRef(options);
+    optionsRef.current = options;
+    const onLoadMoreRef = React.useRef(onLoadMore);
+    onLoadMoreRef.current = onLoadMore;
+    const hasNextPageRef = React.useRef(hasNextPage);
+    hasNextPageRef.current = hasNextPage;
+    const isFetchingMoreRef = React.useRef(isFetchingMore);
+    isFetchingMoreRef.current = isFetchingMore;
+    const sentinelRef = React.useCallback((node)=>{
+        observerRef.current?.disconnect();
+        nodeRef.current = node;
+        if (!node) {
+            return;
+        }
+        const observer = new IntersectionObserver(([entry])=>{
+            if (entry.isIntersecting && hasNextPageRef.current && !isFetchingMoreRef.current) {
+                onLoadMoreRef.current();
+            }
+        }, optionsRef.current);
+        observer.observe(node);
+        observerRef.current = observer;
+    }, []);
+    React.useEffect(()=>()=>observerRef.current?.disconnect(), []);
+    // Once a page settles, re-observe so a *fresh* reading against the new layout
+    // decides whether to keep loading — rather than a stale `isIntersecting` from
+    // before the rows rendered. Re-observing re-emits the current intersection
+    // even without a transition, which is what keeps loading a viewport that a
+    // single page didn't fill.
+    React.useEffect(()=>{
+        if (isFetchingMore || !observerRef.current || !nodeRef.current) {
+            return;
+        }
+        observerRef.current.unobserve(nodeRef.current);
+        observerRef.current.observe(nodeRef.current);
+    }, [
+        isFetchingMore
+    ]);
+    return sentinelRef;
+};
+
+exports.useInfiniteScrollSentinel = useInfiniteScrollSentinel;
+//# sourceMappingURL=useInfiniteScrollSentinel.js.map

package/dist/admin/future/pages/Assets/hooks/useInfiniteScrollSentinel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteScrollSentinel.js","sources":["../../../../../../admin/src/future/pages/Assets/hooks/useInfiniteScrollSentinel.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\n\ninterface UseInfiniteScrollSentinelArgs {\n  /** Whether there is a further page to request. */\n  hasNextPage: boolean;\n  /** Whether a subsequent page is already in flight. */\n  isFetchingMore: boolean;\n  /** Called to request the next page. Held in a ref, so it need not be stable. */\n  onLoadMore: () => void;\n  /**\n   * Passed to the `IntersectionObserver`. Read once, when the sentinel node\n   * attaches — changing it afterwards does NOT rebuild the observer, so a\n   * later `threshold`/`rootMargin` is silently ignored. Pass a stable, ideally\n   * module-level, object.\n   */\n  options?: IntersectionObserverInit;\n}\n\n/**\n * Infinite-scroll trigger for the media library list.\n *\n * Returns a callback ref to place on a sentinel element rendered after the last\n * row. Three deliberate choices:\n *\n * 1. **Loading is driven only by fresh observer readings.** A fetch fires from\n *    the `IntersectionObserver` callback — never from a state/prop change — so\n *    it can't react to a stale `isIntersecting` from before newly loaded rows\n *    rendered (which fetched an extra page on every trigger).\n *\n * 2. **Each settled page re-observes the sentinel.** An `IntersectionObserver`\n *    only fires on a *transition*. When the sentinel stays on screen (a page\n *    that doesn't fill the viewport — tall viewport, short page, grid fitting\n *    the whole page) it would never fire again and loading would stall. So when\n *    `isFetchingMore` settles back to false we re-observe, forcing a fresh\n *    reading against the new layout: still on screen → load the next page;\n *    viewport now filled → stop.\n *\n * 3. **A callback ref, not a stable object ref.** The sentinel only mounts once\n *    the first page has rendered (the list shows a loader before that). A\n *    callback ref (re)binds the observer exactly when the node mounts/unmounts,\n *    so the observer can't miss a sentinel that appears after the hook first ran.\n */\nexport const useInfiniteScrollSentinel = ({\n  hasNextPage,\n  isFetchingMore,\n  onLoadMore,\n  options,\n}: UseInfiniteScrollSentinelArgs) => {\n  const observerRef = useRef<IntersectionObserver | null>(null);\n  const nodeRef = useRef<HTMLElement | null>(null);\n\n  // Read through refs so the callback ref stays stable and the observer callback\n  // always sees the latest values. `options` is read once at attach time (see\n  // its JSDoc); `onLoadMore` need not be stable.\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const onLoadMoreRef = useRef(onLoadMore);\n  onLoadMoreRef.current = onLoadMore;\n  const hasNextPageRef = useRef(hasNextPage);\n  hasNextPageRef.current = hasNextPage;\n  const isFetchingMoreRef = useRef(isFetchingMore);\n  isFetchingMoreRef.current = isFetchingMore;\n\n  const sentinelRef = useCallback((node: HTMLElement | null) => {\n    observerRef.current?.disconnect();\n    nodeRef.current = node;\n\n    if (!node) {\n      return;\n    }\n\n    const observer = new IntersectionObserver(([entry]) => {\n      if (entry.isIntersecting && hasNextPageRef.current && !isFetchingMoreRef.current) {\n        onLoadMoreRef.current();\n      }\n    }, optionsRef.current);\n\n    observer.observe(node);\n    observerRef.current = observer;\n  }, []);\n\n  useEffect(() => () => observerRef.current?.disconnect(), []);\n\n  // Once a page settles, re-observe so a *fresh* reading against the new layout\n  // decides whether to keep loading — rather than a stale `isIntersecting` from\n  // before the rows rendered. Re-observing re-emits the current intersection\n  // even without a transition, which is what keeps loading a viewport that a\n  // single page didn't fill.\n  useEffect(() => {\n    if (isFetchingMore || !observerRef.current || !nodeRef.current) {\n      return;\n    }\n\n    observerRef.current.unobserve(nodeRef.current);\n    observerRef.current.observe(nodeRef.current);\n  }, [isFetchingMore]);\n\n  return sentinelRef;\n};\n"],"names":["useInfiniteScrollSentinel","hasNextPage","isFetchingMore","onLoadMore","options","observerRef","useRef","nodeRef","optionsRef","current","onLoadMoreRef","hasNextPageRef","isFetchingMoreRef","sentinelRef","useCallback","node","disconnect","observer","IntersectionObserver","entry","isIntersecting","observe","useEffect","unobserve"],"mappings":";;;;AAkBA;;;;;;;;;;;;;;;;;;;;;;;AAuBC,IACM,MAAMA,yBAAAA,GAA4B,CAAC,EACxCC,WAAW,EACXC,cAAc,EACdC,UAAU,EACVC,OAAO,EACuB,GAAA;AAC9B,IAAA,MAAMC,cAAcC,YAAAA,CAAoC,IAAA,CAAA;AACxD,IAAA,MAAMC,UAAUD,YAAAA,CAA2B,IAAA,CAAA;;;;AAK3C,IAAA,MAAME,aAAaF,YAAAA,CAAOF,OAAAA,CAAAA;AAC1BI,IAAAA,UAAAA,CAAWC,OAAO,GAAGL,OAAAA;AACrB,IAAA,MAAMM,gBAAgBJ,YAAAA,CAAOH,UAAAA,CAAAA;AAC7BO,IAAAA,aAAAA,CAAcD,OAAO,GAAGN,UAAAA;AACxB,IAAA,MAAMQ,iBAAiBL,YAAAA,CAAOL,WAAAA,CAAAA;AAC9BU,IAAAA,cAAAA,CAAeF,OAAO,GAAGR,WAAAA;AACzB,IAAA,MAAMW,oBAAoBN,YAAAA,CAAOJ,cAAAA,CAAAA;AACjCU,IAAAA,iBAAAA,CAAkBH,OAAO,GAAGP,cAAAA;IAE5B,MAAMW,WAAAA,GAAcC,kBAAY,CAACC,IAAAA,GAAAA;AAC/BV,QAAAA,WAAAA,CAAYI,OAAO,EAAEO,UAAAA,EAAAA;AACrBT,QAAAA,OAAAA,CAAQE,OAAO,GAAGM,IAAAA;AAElB,QAAA,IAAI,CAACA,IAAAA,EAAM;AACT,YAAA;AACF,QAAA;AAEA,QAAA,MAAME,QAAAA,GAAW,IAAIC,oBAAAA,CAAqB,CAAC,CAACC,KAAAA,CAAM,GAAA;YAChD,IAAIA,KAAAA,CAAMC,cAAc,IAAIT,cAAAA,CAAeF,OAAO,IAAI,CAACG,iBAAAA,CAAkBH,OAAO,EAAE;AAChFC,gBAAAA,aAAAA,CAAcD,OAAO,EAAA;AACvB,YAAA;AACF,QAAA,CAAA,EAAGD,WAAWC,OAAO,CAAA;AAErBQ,QAAAA,QAAAA,CAASI,OAAO,CAACN,IAAAA,CAAAA;AACjBV,QAAAA,WAAAA,CAAYI,OAAO,GAAGQ,QAAAA;AACxB,IAAA,CAAA,EAAG,EAAE,CAAA;AAELK,IAAAA,eAAAA,CAAU,IAAM,IAAMjB,WAAAA,CAAYI,OAAO,EAAEO,cAAc,EAAE,CAAA;;;;;;IAO3DM,eAAAA,CAAU,IAAA;QACR,IAAIpB,cAAAA,IAAkB,CAACG,WAAAA,CAAYI,OAAO,IAAI,CAACF,OAAAA,CAAQE,OAAO,EAAE;AAC9D,YAAA;AACF,QAAA;AAEAJ,QAAAA,WAAAA,CAAYI,OAAO,CAACc,SAAS,CAAChB,QAAQE,OAAO,CAAA;AAC7CJ,QAAAA,WAAAA,CAAYI,OAAO,CAACY,OAAO,CAACd,QAAQE,OAAO,CAAA;IAC7C,CAAA,EAAG;AAACP,QAAAA;AAAe,KAAA,CAAA;IAEnB,OAAOW,WAAAA;AACT;;;;"}

package/dist/admin/future/pages/Assets/hooks/useInfiniteScrollSentinel.mjs

@@ -0,0 +1,73 @@
+import { useRef, useCallback, useEffect } from 'react';
+
+/**
+ * Infinite-scroll trigger for the media library list.
+ *
+ * Returns a callback ref to place on a sentinel element rendered after the last
+ * row. Three deliberate choices:
+ *
+ * 1. **Loading is driven only by fresh observer readings.** A fetch fires from
+ *    the `IntersectionObserver` callback — never from a state/prop change — so
+ *    it can't react to a stale `isIntersecting` from before newly loaded rows
+ *    rendered (which fetched an extra page on every trigger).
+ *
+ * 2. **Each settled page re-observes the sentinel.** An `IntersectionObserver`
+ *    only fires on a *transition*. When the sentinel stays on screen (a page
+ *    that doesn't fill the viewport — tall viewport, short page, grid fitting
+ *    the whole page) it would never fire again and loading would stall. So when
+ *    `isFetchingMore` settles back to false we re-observe, forcing a fresh
+ *    reading against the new layout: still on screen → load the next page;
+ *    viewport now filled → stop.
+ *
+ * 3. **A callback ref, not a stable object ref.** The sentinel only mounts once
+ *    the first page has rendered (the list shows a loader before that). A
+ *    callback ref (re)binds the observer exactly when the node mounts/unmounts,
+ *    so the observer can't miss a sentinel that appears after the hook first ran.
+ */ const useInfiniteScrollSentinel = ({ hasNextPage, isFetchingMore, onLoadMore, options })=>{
+    const observerRef = useRef(null);
+    const nodeRef = useRef(null);
+    // Read through refs so the callback ref stays stable and the observer callback
+    // always sees the latest values. `options` is read once at attach time (see
+    // its JSDoc); `onLoadMore` need not be stable.
+    const optionsRef = useRef(options);
+    optionsRef.current = options;
+    const onLoadMoreRef = useRef(onLoadMore);
+    onLoadMoreRef.current = onLoadMore;
+    const hasNextPageRef = useRef(hasNextPage);
+    hasNextPageRef.current = hasNextPage;
+    const isFetchingMoreRef = useRef(isFetchingMore);
+    isFetchingMoreRef.current = isFetchingMore;
+    const sentinelRef = useCallback((node)=>{
+        observerRef.current?.disconnect();
+        nodeRef.current = node;
+        if (!node) {
+            return;
+        }
+        const observer = new IntersectionObserver(([entry])=>{
+            if (entry.isIntersecting && hasNextPageRef.current && !isFetchingMoreRef.current) {
+                onLoadMoreRef.current();
+            }
+        }, optionsRef.current);
+        observer.observe(node);
+        observerRef.current = observer;
+    }, []);
+    useEffect(()=>()=>observerRef.current?.disconnect(), []);
+    // Once a page settles, re-observe so a *fresh* reading against the new layout
+    // decides whether to keep loading — rather than a stale `isIntersecting` from
+    // before the rows rendered. Re-observing re-emits the current intersection
+    // even without a transition, which is what keeps loading a viewport that a
+    // single page didn't fill.
+    useEffect(()=>{
+        if (isFetchingMore || !observerRef.current || !nodeRef.current) {
+            return;
+        }
+        observerRef.current.unobserve(nodeRef.current);
+        observerRef.current.observe(nodeRef.current);
+    }, [
+        isFetchingMore
+    ]);
+    return sentinelRef;
+};
+
+export { useInfiniteScrollSentinel };
+//# sourceMappingURL=useInfiniteScrollSentinel.mjs.map

package/dist/admin/future/pages/Assets/hooks/useInfiniteScrollSentinel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInfiniteScrollSentinel.mjs","sources":["../../../../../../admin/src/future/pages/Assets/hooks/useInfiniteScrollSentinel.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from 'react';\n\ninterface UseInfiniteScrollSentinelArgs {\n  /** Whether there is a further page to request. */\n  hasNextPage: boolean;\n  /** Whether a subsequent page is already in flight. */\n  isFetchingMore: boolean;\n  /** Called to request the next page. Held in a ref, so it need not be stable. */\n  onLoadMore: () => void;\n  /**\n   * Passed to the `IntersectionObserver`. Read once, when the sentinel node\n   * attaches — changing it afterwards does NOT rebuild the observer, so a\n   * later `threshold`/`rootMargin` is silently ignored. Pass a stable, ideally\n   * module-level, object.\n   */\n  options?: IntersectionObserverInit;\n}\n\n/**\n * Infinite-scroll trigger for the media library list.\n *\n * Returns a callback ref to place on a sentinel element rendered after the last\n * row. Three deliberate choices:\n *\n * 1. **Loading is driven only by fresh observer readings.** A fetch fires from\n *    the `IntersectionObserver` callback — never from a state/prop change — so\n *    it can't react to a stale `isIntersecting` from before newly loaded rows\n *    rendered (which fetched an extra page on every trigger).\n *\n * 2. **Each settled page re-observes the sentinel.** An `IntersectionObserver`\n *    only fires on a *transition*. When the sentinel stays on screen (a page\n *    that doesn't fill the viewport — tall viewport, short page, grid fitting\n *    the whole page) it would never fire again and loading would stall. So when\n *    `isFetchingMore` settles back to false we re-observe, forcing a fresh\n *    reading against the new layout: still on screen → load the next page;\n *    viewport now filled → stop.\n *\n * 3. **A callback ref, not a stable object ref.** The sentinel only mounts once\n *    the first page has rendered (the list shows a loader before that). A\n *    callback ref (re)binds the observer exactly when the node mounts/unmounts,\n *    so the observer can't miss a sentinel that appears after the hook first ran.\n */\nexport const useInfiniteScrollSentinel = ({\n  hasNextPage,\n  isFetchingMore,\n  onLoadMore,\n  options,\n}: UseInfiniteScrollSentinelArgs) => {\n  const observerRef = useRef<IntersectionObserver | null>(null);\n  const nodeRef = useRef<HTMLElement | null>(null);\n\n  // Read through refs so the callback ref stays stable and the observer callback\n  // always sees the latest values. `options` is read once at attach time (see\n  // its JSDoc); `onLoadMore` need not be stable.\n  const optionsRef = useRef(options);\n  optionsRef.current = options;\n  const onLoadMoreRef = useRef(onLoadMore);\n  onLoadMoreRef.current = onLoadMore;\n  const hasNextPageRef = useRef(hasNextPage);\n  hasNextPageRef.current = hasNextPage;\n  const isFetchingMoreRef = useRef(isFetchingMore);\n  isFetchingMoreRef.current = isFetchingMore;\n\n  const sentinelRef = useCallback((node: HTMLElement | null) => {\n    observerRef.current?.disconnect();\n    nodeRef.current = node;\n\n    if (!node) {\n      return;\n    }\n\n    const observer = new IntersectionObserver(([entry]) => {\n      if (entry.isIntersecting && hasNextPageRef.current && !isFetchingMoreRef.current) {\n        onLoadMoreRef.current();\n      }\n    }, optionsRef.current);\n\n    observer.observe(node);\n    observerRef.current = observer;\n  }, []);\n\n  useEffect(() => () => observerRef.current?.disconnect(), []);\n\n  // Once a page settles, re-observe so a *fresh* reading against the new layout\n  // decides whether to keep loading — rather than a stale `isIntersecting` from\n  // before the rows rendered. Re-observing re-emits the current intersection\n  // even without a transition, which is what keeps loading a viewport that a\n  // single page didn't fill.\n  useEffect(() => {\n    if (isFetchingMore || !observerRef.current || !nodeRef.current) {\n      return;\n    }\n\n    observerRef.current.unobserve(nodeRef.current);\n    observerRef.current.observe(nodeRef.current);\n  }, [isFetchingMore]);\n\n  return sentinelRef;\n};\n"],"names":["useInfiniteScrollSentinel","hasNextPage","isFetchingMore","onLoadMore","options","observerRef","useRef","nodeRef","optionsRef","current","onLoadMoreRef","hasNextPageRef","isFetchingMoreRef","sentinelRef","useCallback","node","disconnect","observer","IntersectionObserver","entry","isIntersecting","observe","useEffect","unobserve"],"mappings":";;AAkBA;;;;;;;;;;;;;;;;;;;;;;;AAuBC,IACM,MAAMA,yBAAAA,GAA4B,CAAC,EACxCC,WAAW,EACXC,cAAc,EACdC,UAAU,EACVC,OAAO,EACuB,GAAA;AAC9B,IAAA,MAAMC,cAAcC,MAAAA,CAAoC,IAAA,CAAA;AACxD,IAAA,MAAMC,UAAUD,MAAAA,CAA2B,IAAA,CAAA;;;;AAK3C,IAAA,MAAME,aAAaF,MAAAA,CAAOF,OAAAA,CAAAA;AAC1BI,IAAAA,UAAAA,CAAWC,OAAO,GAAGL,OAAAA;AACrB,IAAA,MAAMM,gBAAgBJ,MAAAA,CAAOH,UAAAA,CAAAA;AAC7BO,IAAAA,aAAAA,CAAcD,OAAO,GAAGN,UAAAA;AACxB,IAAA,MAAMQ,iBAAiBL,MAAAA,CAAOL,WAAAA,CAAAA;AAC9BU,IAAAA,cAAAA,CAAeF,OAAO,GAAGR,WAAAA;AACzB,IAAA,MAAMW,oBAAoBN,MAAAA,CAAOJ,cAAAA,CAAAA;AACjCU,IAAAA,iBAAAA,CAAkBH,OAAO,GAAGP,cAAAA;IAE5B,MAAMW,WAAAA,GAAcC,YAAY,CAACC,IAAAA,GAAAA;AAC/BV,QAAAA,WAAAA,CAAYI,OAAO,EAAEO,UAAAA,EAAAA;AACrBT,QAAAA,OAAAA,CAAQE,OAAO,GAAGM,IAAAA;AAElB,QAAA,IAAI,CAACA,IAAAA,EAAM;AACT,YAAA;AACF,QAAA;AAEA,QAAA,MAAME,QAAAA,GAAW,IAAIC,oBAAAA,CAAqB,CAAC,CAACC,KAAAA,CAAM,GAAA;YAChD,IAAIA,KAAAA,CAAMC,cAAc,IAAIT,cAAAA,CAAeF,OAAO,IAAI,CAACG,iBAAAA,CAAkBH,OAAO,EAAE;AAChFC,gBAAAA,aAAAA,CAAcD,OAAO,EAAA;AACvB,YAAA;AACF,QAAA,CAAA,EAAGD,WAAWC,OAAO,CAAA;AAErBQ,QAAAA,QAAAA,CAASI,OAAO,CAACN,IAAAA,CAAAA;AACjBV,QAAAA,WAAAA,CAAYI,OAAO,GAAGQ,QAAAA;AACxB,IAAA,CAAA,EAAG,EAAE,CAAA;AAELK,IAAAA,SAAAA,CAAU,IAAM,IAAMjB,WAAAA,CAAYI,OAAO,EAAEO,cAAc,EAAE,CAAA;;;;;;IAO3DM,SAAAA,CAAU,IAAA;QACR,IAAIpB,cAAAA,IAAkB,CAACG,WAAAA,CAAYI,OAAO,IAAI,CAACF,OAAAA,CAAQE,OAAO,EAAE;AAC9D,YAAA;AACF,QAAA;AAEAJ,QAAAA,WAAAA,CAAYI,OAAO,CAACc,SAAS,CAAChB,QAAQE,OAAO,CAAA;AAC7CJ,QAAAA,WAAAA,CAAYI,OAAO,CAACY,OAAO,CAACd,QAAQE,OAAO,CAAA;IAC7C,CAAA,EAAG;AAACP,QAAAA;AAAe,KAAA,CAAA;IAEnB,OAAOW,WAAAA;AACT;;;;"}

package/dist/admin/future/pages/Assets/utils/selection.js

@@ -39,6 +39,22 @@ const createEmptySelection = ()=>({
         anchorKey: key
     };
 };
+/**
+ * Subtractive counterpart to {@link toggleSelection} — removes a key without the
+ * add-if-absent ambiguity, leaving the rest of the selection alone. Used when a
+ * single-item affordance (a row's "..." menu) makes exactly one key stale.
+ *
+ * Idempotent: removing a key that was never selected is a no-op. The anchor is
+ * dropped only when it is the removed key, so a Shift+click range built around
+ * other rows survives.
+ */ const deselect = (state, key)=>{
+    const selectedKeys = new Set(state.selectedKeys);
+    selectedKeys.delete(key);
+    return {
+        selectedKeys,
+        anchorKey: state.anchorKey === key ? null : state.anchorKey
+    };
+};
 /**
  * Shift+click — selects the contiguous range between the current anchor and the
  * target in render order, replacing the current selection. The anchor stays put.
@@ -95,6 +111,7 @@ const clearSelection = ()=>createEmptySelection();
 exports.assetKey = assetKey;
 exports.clearSelection = clearSelection;
 exports.createEmptySelection = createEmptySelection;
+exports.deselect = deselect;
 exports.folderKey = folderKey;
 exports.getIdsOfKind = getIdsOfKind;
 exports.getSelectAllState = getSelectAllState;

package/dist/admin/future/pages/Assets/utils/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sources":["../../../../../../admin/src/future/pages/Assets/utils/selection.ts"],"sourcesContent":["/**\n * Pure, view-agnostic selection logic for the future Media Library multi-select.\n *\n * Selection covers both assets and folders. Since their numeric ids live in\n * different tables (and can collide), items are tracked as namespaced keys\n * (`asset:1` / `folder:1`). Views build their rendered order as a key array so\n * range / select-all work across the folder and asset sections seamlessly.\n */\n\nexport type SelectableKind = 'asset' | 'folder';\n\nexport type ItemKey = `${SelectableKind}:${number}`;\n\nexport const assetKey = (id: number): ItemKey => `asset:${id}`;\n\nexport const folderKey = (id: number): ItemKey => `folder:${id}`;\n\n/** Extracts the numeric ids of one kind from a set of item keys. */\nexport const getIdsOfKind = (keys: Set<ItemKey>, kind: SelectableKind): Set<number> => {\n  const ids = new Set<number>();\n\n  keys.forEach((key) => {\n    const [keyKind, id] = key.split(':');\n    if (keyKind === kind) {\n      ids.add(Number(id));\n    }\n  });\n\n  return ids;\n};\n\nexport interface SelectionState {\n  /** Currently selected item keys (assets and folders). */\n  selectedKeys: Set<ItemKey>;\n  /** Anchor used as the start of a Shift+click range. */\n  anchorKey: ItemKey | null;\n}\n\nexport const createEmptySelection = (): SelectionState => ({\n  selectedKeys: new Set<ItemKey>(),\n  anchorKey: null,\n});\n\n/**\n * Additive toggle — adds the key if absent, removes it otherwise, without\n * touching the rest of the selection. Used by the item checkbox and Cmd/Ctrl+click.\n * The toggled key becomes the new anchor.\n */\nexport const toggleSelection = (state: SelectionState, key: ItemKey): SelectionState => {\n  const selectedKeys = new Set(state.selectedKeys);\n\n  if (selectedKeys.has(key)) {\n    selectedKeys.delete(key);\n  } else {\n    selectedKeys.add(key);\n  }\n\n  return { selectedKeys, anchorKey: key };\n};\n\n/**\n * Shift+click — selects the contiguous range between the current anchor and the\n * target in render order, replacing the current selection. The anchor stays put.\n *\n * Falls back to a single selection when there is no usable anchor (e.g. first\n * click was a Shift+click, or the anchor is no longer in the list).\n */\nexport const selectRange = (\n  state: SelectionState,\n  orderedKeys: ItemKey[],\n  targetKey: ItemKey\n): SelectionState => {\n  const targetIndex = orderedKeys.indexOf(targetKey);\n\n  if (targetIndex === -1) {\n    return state;\n  }\n\n  const anchorIndex = state.anchorKey === null ? -1 : orderedKeys.indexOf(state.anchorKey);\n\n  if (anchorIndex === -1) {\n    return { selectedKeys: new Set<ItemKey>([targetKey]), anchorKey: targetKey };\n  }\n\n  const start = Math.min(anchorIndex, targetIndex);\n  const end = Math.max(anchorIndex, targetIndex);\n\n  return {\n    selectedKeys: new Set(orderedKeys.slice(start, end + 1)),\n    anchorKey: state.anchorKey,\n  };\n};\n\n/**\n * Select-all — selects every key in the provided ordered array. Used by the header\n * checkbox when not everything is already selected.\n */\nexport const selectAll = (orderedKeys: ItemKey[]): SelectionState => ({\n  selectedKeys: new Set(orderedKeys),\n  anchorKey: orderedKeys.length > 0 ? orderedKeys[orderedKeys.length - 1] : null,\n});\n\nexport const clearSelection = (): SelectionState => createEmptySelection();\n\nexport interface SelectAllState {\n  allSelected: boolean;\n  isIndeterminate: boolean;\n}\n\n/**\n * Derives the header checkbox state: everything selected, some (indeterminate),\n * or none. Only considers the currently-rendered items (orderedKeys).\n */\nexport const getSelectAllState = (\n  selectedKeys: Set<ItemKey>,\n  orderedKeys: ItemKey[]\n): SelectAllState => {\n  if (orderedKeys.length === 0) {\n    return { allSelected: false, isIndeterminate: false };\n  }\n\n  const selectedCount = orderedKeys.reduce(\n    (count, key) => (selectedKeys.has(key) ? count + 1 : count),\n    0\n  );\n  const allSelected = selectedCount === orderedKeys.length;\n\n  return {\n    allSelected,\n    isIndeterminate: selectedCount > 0 && !allSelected,\n  };\n};\n"],"names":["assetKey","id","folderKey","getIdsOfKind","keys","kind","ids","Set","forEach","key","keyKind","split","add","Number","createEmptySelection","selectedKeys","anchorKey","toggleSelection","state","has","delete","selectRange","orderedKeys","targetKey","targetIndex","indexOf","anchorIndex","start","Math","min","end","max","slice","selectAll","length","clearSelection","getSelectAllState","allSelected","isIndeterminate","selectedCount","reduce","count"],"mappings":"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"}
+{"version":3,"file":"selection.js","sources":["../../../../../../admin/src/future/pages/Assets/utils/selection.ts"],"sourcesContent":["/**\n * Pure, view-agnostic selection logic for the future Media Library multi-select.\n *\n * Selection covers both assets and folders. Since their numeric ids live in\n * different tables (and can collide), items are tracked as namespaced keys\n * (`asset:1` / `folder:1`). Views build their rendered order as a key array so\n * range / select-all work across the folder and asset sections seamlessly.\n */\n\nexport type SelectableKind = 'asset' | 'folder';\n\nexport type ItemKey = `${SelectableKind}:${number}`;\n\nexport const assetKey = (id: number): ItemKey => `asset:${id}`;\n\nexport const folderKey = (id: number): ItemKey => `folder:${id}`;\n\n/** Extracts the numeric ids of one kind from a set of item keys. */\nexport const getIdsOfKind = (keys: Set<ItemKey>, kind: SelectableKind): Set<number> => {\n  const ids = new Set<number>();\n\n  keys.forEach((key) => {\n    const [keyKind, id] = key.split(':');\n    if (keyKind === kind) {\n      ids.add(Number(id));\n    }\n  });\n\n  return ids;\n};\n\nexport interface SelectionState {\n  /** Currently selected item keys (assets and folders). */\n  selectedKeys: Set<ItemKey>;\n  /** Anchor used as the start of a Shift+click range. */\n  anchorKey: ItemKey | null;\n}\n\nexport const createEmptySelection = (): SelectionState => ({\n  selectedKeys: new Set<ItemKey>(),\n  anchorKey: null,\n});\n\n/**\n * Additive toggle — adds the key if absent, removes it otherwise, without\n * touching the rest of the selection. Used by the item checkbox and Cmd/Ctrl+click.\n * The toggled key becomes the new anchor.\n */\nexport const toggleSelection = (state: SelectionState, key: ItemKey): SelectionState => {\n  const selectedKeys = new Set(state.selectedKeys);\n\n  if (selectedKeys.has(key)) {\n    selectedKeys.delete(key);\n  } else {\n    selectedKeys.add(key);\n  }\n\n  return { selectedKeys, anchorKey: key };\n};\n\n/**\n * Subtractive counterpart to {@link toggleSelection} — removes a key without the\n * add-if-absent ambiguity, leaving the rest of the selection alone. Used when a\n * single-item affordance (a row's \"...\" menu) makes exactly one key stale.\n *\n * Idempotent: removing a key that was never selected is a no-op. The anchor is\n * dropped only when it is the removed key, so a Shift+click range built around\n * other rows survives.\n */\nexport const deselect = (state: SelectionState, key: ItemKey): SelectionState => {\n  const selectedKeys = new Set(state.selectedKeys);\n  selectedKeys.delete(key);\n\n  return {\n    selectedKeys,\n    anchorKey: state.anchorKey === key ? null : state.anchorKey,\n  };\n};\n\n/**\n * Shift+click — selects the contiguous range between the current anchor and the\n * target in render order, replacing the current selection. The anchor stays put.\n *\n * Falls back to a single selection when there is no usable anchor (e.g. first\n * click was a Shift+click, or the anchor is no longer in the list).\n */\nexport const selectRange = (\n  state: SelectionState,\n  orderedKeys: ItemKey[],\n  targetKey: ItemKey\n): SelectionState => {\n  const targetIndex = orderedKeys.indexOf(targetKey);\n\n  if (targetIndex === -1) {\n    return state;\n  }\n\n  const anchorIndex = state.anchorKey === null ? -1 : orderedKeys.indexOf(state.anchorKey);\n\n  if (anchorIndex === -1) {\n    return { selectedKeys: new Set<ItemKey>([targetKey]), anchorKey: targetKey };\n  }\n\n  const start = Math.min(anchorIndex, targetIndex);\n  const end = Math.max(anchorIndex, targetIndex);\n\n  return {\n    selectedKeys: new Set(orderedKeys.slice(start, end + 1)),\n    anchorKey: state.anchorKey,\n  };\n};\n\n/**\n * Select-all — selects every key in the provided ordered array. Used by the header\n * checkbox when not everything is already selected.\n */\nexport const selectAll = (orderedKeys: ItemKey[]): SelectionState => ({\n  selectedKeys: new Set(orderedKeys),\n  anchorKey: orderedKeys.length > 0 ? orderedKeys[orderedKeys.length - 1] : null,\n});\n\nexport const clearSelection = (): SelectionState => createEmptySelection();\n\nexport interface SelectAllState {\n  allSelected: boolean;\n  isIndeterminate: boolean;\n}\n\n/**\n * Derives the header checkbox state: everything selected, some (indeterminate),\n * or none. Only considers the currently-rendered items (orderedKeys).\n */\nexport const getSelectAllState = (\n  selectedKeys: Set<ItemKey>,\n  orderedKeys: ItemKey[]\n): SelectAllState => {\n  if (orderedKeys.length === 0) {\n    return { allSelected: false, isIndeterminate: false };\n  }\n\n  const selectedCount = orderedKeys.reduce(\n    (count, key) => (selectedKeys.has(key) ? count + 1 : count),\n    0\n  );\n  const allSelected = selectedCount === orderedKeys.length;\n\n  return {\n    allSelected,\n    isIndeterminate: selectedCount > 0 && !allSelected,\n  };\n};\n"],"names":["assetKey","id","folderKey","getIdsOfKind","keys","kind","ids","Set","forEach","key","keyKind","split","add","Number","createEmptySelection","selectedKeys","anchorKey","toggleSelection","state","has","delete","deselect","selectRange","orderedKeys","targetKey","targetIndex","indexOf","anchorIndex","start","Math","min","end","max","slice","selectAll","length","clearSelection","getSelectAllState","allSelected","isIndeterminate","selectedCount","reduce","count"],"mappings":"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"}