@strapi/upload 5.51.0 → 5.51.2

package/dist/admin/src/future/pages/Assets/hooks/useListSort.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Sort state for the assets list, backed by URL query params so the current
+ * ordering is shareable and survives Back/refresh:
+ *
+ * - `?sort=<rule>` — a single whitelisted rule. Omitted → default (most
+ *   recent updates).
+ * - `?folders=mixed` — folders interleaved with files. Omitted → folders on top.
+ *
+ * The date rules and the direction rules are mutually exclusive: exactly one
+ * rule is active at a time (one checkmark total, like the design mock). Picking
+ * an option in one group clears the other; clearing the active option falls
+ * back to the default — an unsorted list is not a state the UI offers.
+ */
+export declare const SORT_BY_RULES: {
+    readonly oldestUploads: "createdAt:ASC";
+    readonly mostRecentUpdates: "updatedAt:DESC";
+};
+export declare const SORT_DIRECTION_RULES: {
+    readonly nameAsc: "name:ASC";
+    readonly nameDesc: "name:DESC";
+    readonly sizeAsc: "size:ASC";
+    readonly sizeDesc: "size:DESC";
+};
+export type SortByKey = keyof typeof SORT_BY_RULES;
+export type SortDirectionKey = keyof typeof SORT_DIRECTION_RULES;
+export type FoldersPosition = 'top' | 'mixed';
+export interface ListSort {
+    sortBy: SortByKey | null;
+    direction: SortDirectionKey | null;
+    foldersPosition: FoldersPosition;
+    /**
+     * The active rule for the files query, e.g. `updatedAt:DESC` — always a
+     * single rule since the sort groups are mutually exclusive.
+     */
+    assetsSort: string;
+    /**
+     * Rule applicable to the folders query. In the default state (no sort in the
+     * URL) folders keep their alphabetical order so the band matches the sidebar
+     * tree; an explicit user sort applies, except size rules (folders have no
+     * `size` column), which fall back to alphabetical.
+     */
+    foldersSort: string;
+    setSortBy: (key: SortByKey | null) => void;
+    setDirection: (key: SortDirectionKey | null) => void;
+    setFoldersPosition: (position: FoldersPosition) => void;
+}
+export declare const useListSort: () => ListSort;

package/dist/admin/src/future/pages/Assets/utils/buildAssetFilters.d.ts

@@ -0,0 +1,46 @@
+import { type ListFilter } from '../hooks/useListFilters';
+/**
+ * Translates the URL filter model into Strapi `filters[$and]` entries for the
+ * files and folders queries, and decides the structural visibility of both
+ * sections.
+ *
+ * Relative presets resolve against `now` at build time — the URL stays
+ * relative ("within the last week"), only the outgoing query is absolute.
+ *
+ * Semantics:
+ * - Every badge is one `$and` entry (badges combine with AND, per ticket).
+ * - Type: `folder` is not a mime — it acts structurally on the folders
+ *   section. The remaining values map to mime clauses; `document` is the
+ *   legacy catch-all (mime contains none of image/audio/video — audio
+ *   included in the exclusion, fixing the legacy quirk).
+ * - Dates apply to files and folders alike (folders have both timestamps).
+ * - "is exactly <preset>" means the calendar day of `now - delta`.
+ * - Ranges are inclusive on both ends (start-of-day .. end-of-day).
+ */
+type QueryClause = Record<string, unknown>;
+/**
+ * Parses `YYYY-MM-DD` as a local calendar date — NOT `new Date(value)`, which
+ * treats date-only strings as UTC midnight and shifts the day in every
+ * timezone west of UTC. Shared by the query builder, the badge labels and the
+ * range calendar so all three agree on which day a range endpoint means.
+ */
+export declare const parseCalendarDate: (value: string) => Date;
+export interface BuiltFilters {
+    /** Extra `$and` entries for the files query. */
+    fileClauses: QueryClause[];
+    /** Extra `$and` entries for the folders query (dates only). */
+    folderClauses: QueryClause[];
+    /**
+     * Whether the folders section can show at all. A type badge decides it by
+     * evaluating "folder" like any other value: `is` shows folders only when
+     * folder is selected; `is not` hides them only when folder is selected.
+     */
+    showFolders: boolean;
+    /**
+     * Whether the files list can show at all — false when an `is` type badge
+     * selects only "folder" (no file can match).
+     */
+    showFiles: boolean;
+}
+export declare const buildAssetFilters: (filters: ListFilter[], now: Date) => BuiltFilters;
+export {};

package/dist/admin/src/future/pages/Assets/utils/listQueryKey.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Fingerprint for "which asset list the user is looking at".
+ *
+ * Selection clears when this key changes (see ClearSelectionOnChange in AssetsPage).
+ *
+ * Hybrid rule
+ * - Folder, search, sort, filter changes → new key → selection clears.
+ * - Switching table/grid view does NOT change the key — both views render the
+ *   same list, so the selection survives the toggle.
+ * - Infinite scroll (load more) does NOT change any segment → selection persists.
+ *
+ * Filter uses a stable default until its header control is wired; that follow-up
+ * only passes a real value — no selection logic changes needed.
+ */
+export interface ListQueryKeyInput {
+    folderId: number | null;
+    search: string;
+    /** Composite of asset sort and folder position — both change the render order. */
+    sort: string | null;
+    /** Null until filter UI ships. */
+    filter: string | null;
+}
+/**
+ * Builds a stable fingerprint for the current asset list query.
+ *
+ * Selection clears when this key changes. Infinite scroll does not change any
+ * segment, so selection persists across load-more.
+ */
+export declare const getListQueryKey: ({ folderId, search, sort, filter }: ListQueryKeyInput) => string;

package/dist/admin/src/future/pages/Assets/utils/mergeMixedList.d.ts

@@ -0,0 +1,40 @@
+import type { File } from '../../../../../../shared/contracts/files';
+import type { Folder } from '../../../../../../shared/contracts/folders';
+export type MixedItem = {
+    kind: 'folder';
+    folder: Folder;
+} | {
+    kind: 'asset';
+    asset: File;
+};
+type SortableRecord = {
+    name?: string | null;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    size?: number | null;
+};
+/**
+ * Builds a comparator from comma-separated sort rules (`updatedAt:DESC,name:ASC`).
+ * Rules apply in order; the first non-equal field decides. Client-side
+ * approximation of the server ordering — good enough to slot folders between
+ * files that were sorted server-side by the same rules.
+ */
+export declare const buildComparator: (sort: string) => (a: SortableRecord, b: SortableRecord) => number;
+interface MergeMixedListParams {
+    folders: Folder[];
+    assets: File[];
+    /** Combined sort rules used for the assets query. */
+    sort: string;
+    /**
+     * More asset pages exist. A folder may only be placed once we know no
+     * not-yet-loaded asset sorts before it — i.e. it compares ≤ the last loaded
+     * asset. Later pages release the remaining folders progressively.
+     */
+    hasNextPage: boolean;
+}
+/**
+ * Interleaves the complete folder list into the (possibly partially loaded)
+ * asset stream according to the active sort. Ties order folders first.
+ */
+export declare const mergeMixedList: ({ folders, assets, sort, hasNextPage, }: MergeMixedListParams) => MixedItem[];
+export {};

package/dist/admin/src/future/pages/Assets/utils/selection.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Pure, view-agnostic selection logic for the future Media Library multi-select.
+ *
+ * Selection covers both assets and folders. Since their numeric ids live in
+ * different tables (and can collide), items are tracked as namespaced keys
+ * (`asset:1` / `folder:1`). Views build their rendered order as a key array so
+ * range / select-all work across the folder and asset sections seamlessly.
+ */
+export type SelectableKind = 'asset' | 'folder';
+export type ItemKey = `${SelectableKind}:${number}`;
+export declare const assetKey: (id: number) => ItemKey;
+export declare const folderKey: (id: number) => ItemKey;
+/** Extracts the numeric ids of one kind from a set of item keys. */
+export declare const getIdsOfKind: (keys: Set<ItemKey>, kind: SelectableKind) => Set<number>;
+export interface SelectionState {
+    /** Currently selected item keys (assets and folders). */
+    selectedKeys: Set<ItemKey>;
+    /** Anchor used as the start of a Shift+click range. */
+    anchorKey: ItemKey | null;
+}
+export declare const createEmptySelection: () => SelectionState;
+/**
+ * Additive toggle — adds the key if absent, removes it otherwise, without
+ * touching the rest of the selection. Used by the item checkbox and Cmd/Ctrl+click.
+ * The toggled key becomes the new anchor.
+ */
+export declare const toggleSelection: (state: SelectionState, key: ItemKey) => SelectionState;
+/**
+ * Shift+click — selects the contiguous range between the current anchor and the
+ * target in render order, replacing the current selection. The anchor stays put.
+ *
+ * Falls back to a single selection when there is no usable anchor (e.g. first
+ * click was a Shift+click, or the anchor is no longer in the list).
+ */
+export declare const selectRange: (state: SelectionState, orderedKeys: ItemKey[], targetKey: ItemKey) => SelectionState;
+/**
+ * Select-all — selects every key in the provided ordered array. Used by the header
+ * checkbox when not everything is already selected.
+ */
+export declare const selectAll: (orderedKeys: ItemKey[]) => SelectionState;
+export declare const clearSelection: () => SelectionState;
+export interface SelectAllState {
+    allSelected: boolean;
+    isIndeterminate: boolean;
+}
+/**
+ * Derives the header checkbox state: everything selected, some (indeterminate),
+ * or none. Only considers the currently-rendered items (orderedKeys).
+ */
+export declare const getSelectAllState: (selectedKeys: Set<ItemKey>, orderedKeys: ItemKey[]) => SelectAllState;

package/dist/admin/src/future/services/api.d.ts

@@ -1,11 +1,20 @@
-import type { CreateFilesStream, File as UploadedFile, UploadFileInfo } from '../../../../shared/contracts/files';
+import { Dispatch } from '@reduxjs/toolkit';
+import type { CreateFilesStream, File as UploadedFile, UnstableGenerateAIMetadata, UploadFileInfo } from '../../../../shared/contracts/files';
 interface UploadFilesArgs {
     formData: FormData;
     totalFiles: number;
+    /**
+     * How many files to upload in parallel — the `concurrentUploadRequests`
+     * settings value. Defaults to 1 (sequential).
+     */
+    concurrency?: number;
+    /** Whether AI metadata generation is enabled (EE AI available + `settings.aiMetadata`). */
+    generateAiMetadata: boolean;
 }
 interface UploadFromUrlsArgs {
     urls: string[];
     folderId: number | null;
+    generateAiMetadata: boolean;
 }
 /**
  * A single file plus the `fileInfo` it was queued with.
@@ -22,10 +31,33 @@ interface UploadEntry {
  * Called from the UploadProgressDialog when the user clicks cancel or close.
  */
 export declare const abortUpload: (uploadId: number) => void;
+/**
+ * Kicks off AI metadata generation for a freshly uploaded file.
+ *
+ * Deliberately fire-and-forget — the caller must NOT await it:
+ *  - generation for file N overlaps the upload of file N+1;
+ *  - a generation failure can never affect the upload result (the upload already
+ *    succeeded), which is why the promise is fully swallowed here.
+ *
+ * Every uploaded file is sent, including non-images: the server already classifies
+ * them (`ai-metadata.generateForFiles` returns `skipped` for anything whose mime
+ * isn't `image/*`) and duplicating that rule here would let the two drift apart.
+ * The upshot is that a non-image now reports "Metadata generation skipped" rather
+ * than silently showing no metadata state at all.
+ */
+export declare const maybeGenerateMetadata: ({ file, index, uploadId, enabled, dispatch, }: {
+    file: UploadedFile;
+    index: number;
+    uploadId: number;
+    enabled: boolean;
+    dispatch: Dispatch;
+}) => void;
 declare const uploadApi: import("@reduxjs/toolkit/query").Api<import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, import("@reduxjs/toolkit/dist/query/endpointDefinitions").UpdateDefinitions<{}, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", never> & {
     /**
-     * Upload files sequentially, one request per file, to `/upload/unstable/upload-file`.
-     * Real per-file byte progress comes from `XHR.upload.onprogress`.
+     * Upload files to `/upload/unstable/upload-file`, one request per file,
+     * through a worker pool of `concurrency` parallel requests (default 1 =
+     * sequential). Real per-file byte progress comes from
+     * `XHR.upload.onprogress`.
      */
     uploadFiles: import("@reduxjs/toolkit/query").MutationDefinition<UploadFilesArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile[], "adminApi">;
     /**
@@ -39,7 +71,7 @@ declare const uploadApi: import("@reduxjs/toolkit/query").Api<import("@reduxjs/t
     /**
      * Retry uploading cancelled files.
      * Maps cancelled rows back to their original entries and re-runs only those
-     * through the same sequential loop with a fresh AbortController.
+     * through the same upload pool with a fresh AbortController.
      */
     retryCancelledFiles: import("@reduxjs/toolkit/query").MutationDefinition<void, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile[], "adminApi">;
     /**
@@ -47,6 +79,22 @@ declare const uploadApi: import("@reduxjs/toolkit/query").Api<import("@reduxjs/t
      * Sends URLs to the server which fetches and uploads them (SSE flow, unchanged).
      */
     uploadFromUrls: import("@reduxjs/toolkit/query").MutationDefinition<UploadFromUrlsArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", CreateFilesStream.Response, "adminApi">;
+    /**
+     * Generate AI metadata (alt text + caption) for the given assets.
+     * Synchronous: resolves once every file has been processed and reports the
+     * outcome per file, so non-images and individual failures don't fail the
+     * whole batch. Existing alt text and captions are never overwritten.
+     *
+     * Lives here rather than in `assets.ts` because the upload flows dispatch it
+     * directly via `initiate()` after each file completes, and `assets.ts` already
+     * imports from this module — defining it there would be a circular import.
+     * Re-exported from `assets.ts` for the components that consume the hook.
+     */
+    generateAiMetadata: import("@reduxjs/toolkit/query").MutationDefinition<{
+        fileIds: number[];
+    }, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UnstableGenerateAIMetadata.FileResult[], "adminApi">;
 }, "adminApi", "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", typeof import("@reduxjs/toolkit/query").coreModuleName | typeof import("@reduxjs/toolkit/dist/query/react").reactHooksModuleName>;
-export declare const useUploadFilesMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UploadFilesArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile[], "adminApi">>, useUploadFileSilentlyMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UploadEntry, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile, "adminApi">>, useRetryCancelledFilesMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<void, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile[], "adminApi">>, useUploadFromUrlsMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UploadFromUrlsArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", CreateFilesStream.Response, "adminApi">>;
+export declare const useUploadFilesMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UploadFilesArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile[], "adminApi">>, useUploadFileSilentlyMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UploadEntry, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile, "adminApi">>, useRetryCancelledFilesMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<void, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UploadedFile[], "adminApi">>, useUploadFromUrlsMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UploadFromUrlsArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", CreateFilesStream.Response, "adminApi">>, useGenerateAiMetadataMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<{
+    fileIds: number[];
+}, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", UnstableGenerateAIMetadata.FileResult[], "adminApi">>;
 export { uploadApi };

package/dist/admin/src/future/services/assets.d.ts

@@ -4,6 +4,9 @@ interface GetAssetsParams {
     pageSize?: number;
     folder?: number | null;
     sort?: string;
+    search?: string;
+    /** Extra `filters[$and]` entries (list filters), AND-ed with the folder/search scope. */
+    filters?: Record<string, unknown>[];
 }
 interface GetAssetsResponse {
     results: File[];
@@ -18,5 +21,13 @@ interface ReplaceAssetArgs {
     file: globalThis.File;
     fileInfo?: Partial<UploadFileInfo>;
 }
-export declare const useGetAssetsQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<void | GetAssetsParams, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", GetAssetsResponse, "adminApi">>, useGetAssetQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<number, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", AssetWithPopulatedCreatedBy, "adminApi">>, useUpdateAssetMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UpdateAssetArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", AssetWithPopulatedCreatedBy, "adminApi">>, useReplaceAssetMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<ReplaceAssetArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", AssetWithPopulatedCreatedBy, "adminApi">>, useDeleteAssetMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<number, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", unknown, "adminApi">>;
-export {};
+export declare const useGetAssetsQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<void | GetAssetsParams, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", GetAssetsResponse, "adminApi">>, useGetAssetQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<number, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", AssetWithPopulatedCreatedBy, "adminApi">>, useUpdateAssetMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<UpdateAssetArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", AssetWithPopulatedCreatedBy, "adminApi">>, useReplaceAssetMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<ReplaceAssetArgs, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", AssetWithPopulatedCreatedBy, "adminApi">>, useDeleteAssetMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<number, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", unknown, "adminApi">>, useBulkDeleteItemsMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<{
+    fileIds: number[];
+    folderIds: number[];
+}, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", unknown, "adminApi">>;
+/**
+ * `generateAiMetadata` is defined in `./api` (the upload flows dispatch it directly
+ * after each file completes, and this module imports from there) — re-exported here
+ * so asset components keep a single import site for asset-related hooks.
+ */
+export { useGenerateAiMetadataMutation } from './api';

package/dist/admin/src/future/services/folders.d.ts

@@ -9,11 +9,17 @@ export type FolderWithCounts = Omit<Folder, 'children' | 'files'> & {
 };
 interface GetFoldersParams {
     parentId?: number | null;
+    /** Comma-separated rules, e.g. `updatedAt:DESC,name:ASC`. Defaults to alphabetical. */
+    sort?: string;
+    search?: string;
+    /** Extra `filters[$and]` entries (list filters), AND-ed with the parent/search scope. */
+    filters?: Record<string, unknown>[];
 }
 interface BulkMoveParams {
     fileIds?: number[];
     folderIds?: number[];
-    destinationFolderId: number;
+    /** `null` moves the items to the root of the Media Library. */
+    destinationFolderId: number | null;
 }
 export declare const useCreateFolderMutation: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseMutation<import("@reduxjs/toolkit/query").MutationDefinition<Pick<Folder, "name" | "parent">, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", Folder, "adminApi">>, useGetFoldersQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<void | GetFoldersParams, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", Folder[], "adminApi">>, useGetFolderQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<{
     id: number;

package/dist/admin/src/future/services/settings.d.ts

@@ -1,2 +1,2 @@
-declare const useGetSettingsQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<void, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", import("../../../../shared/contracts/settings").Settings, "adminApi">>;
-export { useGetSettingsQuery };
+declare const useGetUploadSettingsQuery: import("@reduxjs/toolkit/dist/query/react/buildHooks").UseQuery<import("@reduxjs/toolkit/query").QueryDefinition<void, import("@reduxjs/toolkit/query").BaseQueryFn<string | import("@strapi/admin/strapi-admin").QueryArguments, unknown, import("@strapi/admin/strapi-admin").BaseQueryError | import("@reduxjs/toolkit").SerializedError, {}, {}>, "GuidedTourMeta" | "HomepageKeyStatistics" | "AiUsage" | "AiFeatureConfig" | "Asset" | "Folder", import("../../../../shared/contracts/settings").Settings, "adminApi">>;
+export { useGetUploadSettingsQuery };

package/dist/admin/src/future/store/uploadProgress.d.ts

@@ -4,6 +4,14 @@ export interface FileUploadError {
     message: string;
 }
 export type FileProgressStatus = 'pending' | 'uploading' | 'complete' | 'error' | 'cancelled';
+/**
+ * AI metadata generation phase for a single row, tracked independently from the
+ * upload status: a metadata failure never turns a successful upload into an error.
+ * `undefined` means the row has no metadata phase at all, i.e. AI metadata is
+ * disabled — non-images do get a phase and come back `skipped` from the server.
+ */
+export type FileMetadataStatus = 'generating' | 'generated' | 'skipped' | 'failed';
+export type FileMetadataResultStatus = Exclude<FileMetadataStatus, 'generating'>;
 export interface FileProgress {
     name: string;
     index: number;
@@ -12,6 +20,7 @@ export interface FileProgress {
     uploadedBytes: number;
     file?: File;
     error?: string;
+    metadataStatus?: FileMetadataStatus;
 }
 export interface UploadProgressState {
     isVisible: boolean;
@@ -35,6 +44,72 @@ export declare const selectAggregateProgress: ((state: RootState) => number) & i
 }> & {
     clearCache: () => void;
 };
+/**
+ * Count-based metadata progress across the whole batch: `settled / expected`.
+ *
+ * Count-based rather than byte-weighted because the generation endpoint answers in one
+ * go — there is no intermediate progress to weight.
+ *
+ * The denominator is every row *expected* to enter the phase, not just those that
+ * already have. Generation is fired per file as each upload finishes, so counting only
+ * started rows made the denominator grow mid-batch and the percentage jump backwards
+ * (1/1 = 100%, then a second row starts and it drops to 1/2 = 50%), which flickered the
+ * header subtitle on and off once per file.
+ *
+ * "Expected" is derived from upload outcome rather than from the AI-metadata flag:
+ *  - a row still uploading may yet enter the phase, so it counts toward the total;
+ *  - an errored or cancelled row never will, so it must not — otherwise a batch with
+ *    one failure could never reach 100%.
+ *
+ * Returns `null` when nothing has entered the phase and nothing is pending — i.e. AI
+ * metadata is off, or the batch is done — so the header can hide the subtitle.
+ */
+export declare const selectMetadataProgress: ((state: RootState) => number | null) & import("reselect").OutputSelectorFields<(args_0: FileProgress[]) => number | null, {
+    clearCache: () => void;
+}> & {
+    clearCache: () => void;
+};
+/**
+ * Whether the metadata phase is still ongoing for the batch as a whole.
+ *
+ * The header uses this — not `selectMetadataProgress === 100` — to decide when to drop
+ * the subtitle. Two distinct reasons the phase can be unfinished:
+ *  - a row is generating right now;
+ *  - no row is generating this instant, but rows are still uploading and will enter the
+ *    phase when they finish.
+ *
+ * The second clause is what keeps the subtitle stable. Generation for file N typically
+ * finishes before file N+1 finishes uploading, so a naive "is anything generating?"
+ * check goes false between every pair of files and blinks the subtitle out and back in.
+ */
+export declare const selectIsGeneratingMetadata: ((state: RootState) => boolean) & import("reselect").OutputSelectorFields<(args_0: FileProgress[]) => boolean, {
+    clearCache: () => void;
+}> & {
+    clearCache: () => void;
+};
+/**
+ * How many rows reached each terminal metadata outcome, for the header's completion
+ * message. `null` while the phase is unfinished — or was never entered at all — so the
+ * caller has a single check for "there is no settled outcome to report yet".
+ *
+ * Counts are reported separately rather than collapsed into one total because they are
+ * not interchangeable: only `generated` rows actually had metadata written, so only that
+ * count can be claimed as a success. A batch of non-images settles entirely on `skipped`,
+ * where "generated on 0 files" would be worse than saying nothing.
+ */
+export declare const selectMetadataOutcome: ((state: RootState) => {
+    generated: number;
+    skipped: number;
+    failed: number;
+} | null) & import("reselect").OutputSelectorFields<(args_0: FileProgress[]) => {
+    generated: number;
+    skipped: number;
+    failed: number;
+} | null, {
+    clearCache: () => void;
+}> & {
+    clearCache: () => void;
+};
 export declare const openUploadProgress: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     totalFiles: number;
     fileNames: string[];
@@ -53,7 +128,14 @@ export declare const openUploadProgress: import("@reduxjs/toolkit").ActionCreato
     index: number;
     name: string;
     message: string;
-}, "uploadProgress/setFileError">, addUploadErrors: import("@reduxjs/toolkit").ActionCreatorWithPayload<FileUploadError[], "uploadProgress/addUploadErrors">, closeUploadProgress: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"uploadProgress/closeUploadProgress">, toggleMinimize: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"uploadProgress/toggleMinimize">, cancelUpload: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"uploadProgress/cancelUpload">, setUploadFailed: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+}, "uploadProgress/setFileError">, setFileMetadataGenerating: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    index: number;
+    uploadId: number;
+}, "uploadProgress/setFileMetadataGenerating">, setFileMetadataResult: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    index: number;
+    uploadId: number;
+    status: FileMetadataResultStatus;
+}, "uploadProgress/setFileMetadataResult">, addUploadErrors: import("@reduxjs/toolkit").ActionCreatorWithPayload<FileUploadError[], "uploadProgress/addUploadErrors">, closeUploadProgress: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"uploadProgress/closeUploadProgress">, toggleMinimize: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"uploadProgress/toggleMinimize">, cancelUpload: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"uploadProgress/cancelUpload">, setUploadFailed: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     message: string;
 }, "uploadProgress/setUploadFailed">, retryCancelledFiles: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"uploadProgress/retryCancelledFiles">;
 export declare const uploadProgressReducer: import("redux").Reducer<UploadProgressState>;

package/dist/admin/src/future/types/dnd.d.ts

@@ -16,6 +16,11 @@ export interface FolderTargetData {
     id: number;
     name: string;
 }
+export interface FolderTreeTargetData {
+    kind: 'folder-tree-target';
+    id: number | null;
+    name: string;
+}
 export interface BulkMovePayload {
     fileIds: number[];
     folderIds: number[];

package/dist/admin/src/future/utils/buildDragSetFromSelection.d.ts

@@ -0,0 +1,11 @@
+import type { DragItemData } from '../types/dnd';
+/**
+ * Reconstruct the drag set from a bulk-actions selection so the dialog can feed
+ * the exact same `DragItemData[]` into `computeValidDropTargets` / the canonical
+ * `canDropItemOnFolder` predicate that pointer drag uses.
+ *
+ * Selection is page-scoped to the current folder, so every selected item shares
+ * `currentFolderId` as its location (files → `folderId`, folders → `parentId`).
+ * Names are irrelevant to drop validation, so they are left empty.
+ */
+export declare const buildDragSetFromSelection: (selectedIds: ReadonlySet<number>, selectedFolderIds: ReadonlySet<number>, currentFolderId: number | null) => DragItemData[];

package/dist/admin/src/future/utils/canDropItemOnFolder.d.ts

@@ -2,7 +2,7 @@ import type { FolderNode } from '../../../../shared/contracts/folders';
 import type { DragItemData } from '../types/dnd';
 export interface CanDropItemOnFolderParams {
     items: DragItemData[];
-    targetFolderId: number;
+    targetFolderId: number | null;
     folderStructure: FolderNode[];
 }
 export declare const isFolderDescendantOf: (folderStructure: FolderNode[], ancestorId: number, candidateId: number) => boolean;

package/dist/admin/src/future/utils/flattenFolderStructure.d.ts

@@ -0,0 +1,18 @@
+import type { FolderNode } from '../../../../shared/contracts/folders';
+export interface FlatFolderOption {
+    id: number;
+    /** Full ancestry label, e.g. "About / Images". */
+    label: string;
+}
+/**
+ * Flattens the nested folder structure (`/upload/folder-structure`) into a
+ * depth-first list of `{ id, label }` options where the label carries the full
+ * ancestry path. Used by destination selects so folders sharing a name stay
+ * distinguishable ("About / Images" vs "Tech / Images"), with children listed
+ * right under their parent.
+ *
+ * `excludeSubtreeIds` prunes a folder *and everything below it* in the same
+ * single pass — used to drop the selected folders (and their descendants) from
+ * bulk-move destinations without re-walking the tree per option.
+ */
+export declare const flattenFolderStructure: (nodes: FolderNode[], excludeSubtreeIds?: ReadonlySet<number>, parentLabel?: string) => FlatFolderOption[];

package/dist/admin/src/future/utils/formatMoveSuccessMessage.d.ts

@@ -0,0 +1,14 @@
+import type { IntlShape } from 'react-intl';
+interface FormatMoveSuccessArgs {
+    formatMessage: IntlShape['formatMessage'];
+    count: number;
+    source: string;
+    destination: string;
+}
+/**
+ * Single source of truth for the bulk-move success wording. Both the DnD drop
+ * and the BulkMoveDialog format the toast (and DnD live-region announcement)
+ * through here so the two paths stay identical for the same move.
+ */
+export declare const formatMoveSuccessMessage: ({ formatMessage, count, source, destination, }: FormatMoveSuccessArgs) => string;
+export {};

package/dist/admin/src/future/utils/getFolderLabel.d.ts

@@ -0,0 +1,11 @@
+import type { FolderNode } from '../../../../shared/contracts/folders';
+/**
+ * Leaf display name for a folder id. `null` (root) → the Media Library label.
+ * Used by both the DnD success toast and the dialog success toast so the two
+ * paths name folders identically. Ancestry paths belong only in the dialog's
+ * select options (see `flattenFolderStructure`).
+ *
+ * `id === null` returns `rootLabel`; an unknown id falls back to `rootLabel`
+ * too (defensive — mirrors the dialog's previous `?? rootLabel`).
+ */
+export declare const getFolderLabel: (folderStructure: FolderNode[], id: number | null, rootLabel: string) => string;

package/dist/admin/src/future/utils/searchQueryParam.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `_q` must be encoded on both hops: `useQueryParams.setQuery` and the fetch
+ * client both stringify with `{ encode: false }`, so an unencoded `&` would
+ * truncate the query. `qs.parse` decodes `+` as a space, so `+` needs escaping
+ * beyond what `encodeURIComponent` does.
+ */
+export declare const encodeSearchQuery: (value: string) => string;

package/dist/admin/src/hooks/useAiAvailability.d.ts

@@ -1,4 +1,4 @@
 export declare const useAIAvailability: () => {
-    status: "loading" | "success" | "error" | "idle";
+    status: "success" | "error" | "loading" | "idle";
     isEnabled: boolean | undefined;
 };