@strapi/upload 5.51.1 → 5.52.0

package/dist/admin/src/future/components/Drawer.d.ts

@@ -3,8 +3,12 @@ import * as Dialog from '@radix-ui/react-dialog';
 import { FlexProps } from '@strapi/design-system';
 /** Duration of the close animation in ms. Use for timing cleanup (e.g. removing URL params). */
 export declare const DRAWER_CLOSE_ANIMATION_MS = 300;
-interface DrawerBodyProps extends FlexProps {
+interface DrawerBodyProps extends Omit<FlexProps, 'width' | 'maxHeight'> {
     animationDirection?: 'up' | 'left';
+    /** Width of the panel from the medium breakpoint up. Mobile is always full-bleed. */
+    width?: string;
+    /** Cap on the panel height. Defaults to the dynamic viewport height. */
+    maxHeight?: string;
     children: React.ReactNode;
 }
 interface DrawerRootProps {

package/dist/admin/src/future/hooks/useAIMetadataEnabled.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Whether the replace flow will actually regenerate AI metadata, so the UI only
+ * promises it when it happens.
+ *
+ * Two independent gates, both required — `GET /upload/settings` returns the
+ * stored `aiMetadata` toggle on its own, which stays `true` (its default) on
+ * licenses without AI, so the setting alone over-promises. The server's own
+ * check (`aiMetadata.isEnabled()`) ANDs the same two conditions.
+ *
+ * Pass `{ mime }` to add the third gate the replace flow applies: it only
+ * regenerates metadata for images the AI provider can read
+ * (`admin-upload.replaceFile` → `aiMetadata.processFiles`, which filters on this
+ * same allowlist). Promising it for a PDF — or for a GIF, which clears the
+ * server's looser `image/*` gate but is skipped by the provider — would describe
+ * something that never happens.
+ *
+ * The argument is an object rather than a bare `mime` so the two intents stay
+ * distinguishable: `File.mime` is optional on the contract, so a positional
+ * parameter let `useAIMetadataEnabled(asset.mime)` collapse into the ungated
+ * call whenever the mime was missing — silently taking the permissive path this
+ * hook exists to close. `useAIMetadataEnabled({ mime: undefined })` still gates
+ * (and fails closed); only an omitted `options` skips the mime check.
+ */
+export declare const useAIMetadataEnabled: (options?: {
+    mime?: string | null;
+}) => boolean;

package/dist/admin/src/future/hooks/useMediaLibraryPermissions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * RBAC gate for the future Media Library UI. Mirrors the legacy hook of the
+ * same name: the server already enforces every action route-side (assets and
+ * folder operations share the asset permissions — folder create requires
+ * `assets.create`, folder rename/move/delete require `assets.update`); this
+ * hook is what keeps the UI honest so users don't discover a missing
+ * permission through a 403.
+ *
+ * - `canCreate` — upload (files, from URL) and New folder
+ * - `canUpdate` — edit details, replace, crop, move (dnd + bulk), delete
+ *   (single + bulk), AI metadata — the `assets.update` action covers
+ *   "Update (crop, details, replace) + delete" by definition
+ * - `canDownload` / `canCopyLink` — the matching drawer actions
+ */
+export declare const useMediaLibraryPermissions: () => {
+    isLoading: boolean;
+    canCreate: boolean;
+    canUpdate: boolean;
+    canDownload: boolean;
+    canCopyLink: boolean;
+};

package/dist/admin/src/future/pages/Assets/components/ActionsMenuContent.d.ts

@@ -0,0 +1,33 @@
+import { Menu } from '@strapi/design-system';
+/**
+ * `Menu.Content` for the row-level "..." menus, with the design system's height
+ * clamp replaced by a viewport-aware one.
+ *
+ * The DS caps its menus at a flat `15rem` and hides the scrollbar
+ * (`scrollbar-width: none` + `::-webkit-scrollbar { display: none }`). Under a
+ * last-row trigger that clamp cut items off with nothing on screen to hint they
+ * were there — Delete simply wasn't reachable.
+ *
+ * Raising the cap to `fit-content` fixed that, but it removes the fallback too:
+ * the box then grows to its content and the DS's `overflow: auto` can never
+ * fire. At 200% zoom or in a short window the menu ends up taller than the
+ * viewport with no way to scroll it — the same items-you-can't-reach bug, moved
+ * to a different trigger condition (WCAG 1.4.4 / 1.4.10).
+ *
+ * So cap to the space Radix measured instead. `--radix-popper-available-height`
+ * is set on the content element by `@radix-ui/react-popper`, and the DS mounts
+ * this box as the popper content (`asChild`), so it resolves here. The fallback
+ * in `min()` covers the first paint, before the property is written. Radix's
+ * collision flip still picks the side with more room; this only decides what
+ * happens when neither side has enough. The scrollbar is un-hidden so the
+ * overflow is visible when it does happen.
+ */
+export declare const ActionsMenuContent: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<Omit<Omit<Menu.ContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, "key" | "id" | "slot" | "style" | "title" | "children" | keyof import("@strapi/design-system").TransientBoxProps | "ref" | keyof import("@strapi/design-system").TransientFlexProps | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onResize" | "onResizeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | keyof import("@strapi/design-system/dist/types").AsProp<"div"> | "onCloseAutoFocus" | "intersectionId" | "popoverPlacement"> & Omit<Omit<Menu.ContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, "maxHeight"> & Partial<Pick<import("styled-components").FastOmit<Omit<Omit<Menu.ContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, "key" | "id" | "slot" | "style" | "title" | "children" | keyof import("@strapi/design-system").TransientBoxProps | "ref" | keyof import("@strapi/design-system").TransientFlexProps | "defaultChecked" | "defaultValue" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoFocus" | "className" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "hidden" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCapitalize" | "autoCorrect" | "autoSave" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "is" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onResize" | "onResizeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | keyof import("@strapi/design-system/dist/types").AsProp<"div"> | "onCloseAutoFocus" | "intersectionId" | "popoverPlacement"> & Omit<Omit<Menu.ContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void | import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof import("react").DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, "maxHeight">>> & string & Omit<import("react").ForwardRefExoticComponent<Omit<Menu.ContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>, keyof import("react").Component<any, {}, any>>;

package/dist/admin/src/future/pages/Assets/components/AssetActionsMenu.d.ts

@@ -0,0 +1,24 @@
+import type { File } from '../../../../../../shared/contracts/files';
+import type { DragFileData } from '../../../types/dnd';
+interface AssetActionsMenuProps {
+    asset: File;
+    /** Drag data for this asset, so the move dialog validates against its real folder. */
+    dragData: DragFileData;
+}
+/**
+ * The "..." menu on an asset row/card. Always acts on that one asset, whatever
+ * the current multi-selection is (the bulk actions bar is the selection-scoped
+ * affordance) — the file mirror of `FolderActionsMenu`.
+ *
+ * Replace / copy link / download duplicate what the details drawer offers as
+ * icon buttons, so the same action is one click away without opening the asset
+ * first. They are re-implemented rather than lifted out of the drawer: the
+ * drawer versions render as `IconButton`s and report through its in-drawer toast
+ * slot, neither of which fits a menu item on a row.
+ *
+ * Any successful move or delete clears the whole selection: a delete only
+ * invalidates RTK tags, so without it an `asset:<id>` key for a file that no
+ * longer exists would linger in the selection.
+ */
+export declare const AssetActionsMenu: ({ asset, dragData }: AssetActionsMenuProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/admin/src/future/pages/Assets/components/AssetDetails/AssetCropEditor.d.ts

@@ -5,6 +5,12 @@ interface AssetCropEditorProps {
     onClose: () => void;
     onApply: (file: globalThis.File, focalPoint: FocalPoint) => void;
     onSaveAsCopy: (file: globalThis.File, focalPoint: FocalPoint) => void;
+    /**
+     * "Save as copy" creates a new asset (`assets.create`), a different permission
+     * from cropping in place (`assets.update`). Hidden when the user lacks it, so
+     * an update-only role can't trigger a 403.
+     */
+    canSaveAsCopy: boolean;
 }
-export declare const AssetCropEditor: ({ asset, isBusy, onClose, onApply, onSaveAsCopy, }: AssetCropEditorProps) => import("react/jsx-runtime").JSX.Element;
+export declare const AssetCropEditor: ({ asset, isBusy, onClose, onApply, onSaveAsCopy, canSaveAsCopy, }: AssetCropEditorProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/admin/src/future/pages/Assets/components/AssetDetails/AssetDetailsDrawer.d.ts

@@ -21,6 +21,22 @@ export declare const useAssetDetailsParam: () => {
     openDetails: (id: number) => void;
     closeDetails: () => void;
 };
+/**
+ * Map the drawer-scoped mutation flags to a single i18n message for the busy
+ * overlay loader. Returns `null` when nothing is in flight.
+ *
+ * Exported for the unit test: the branch order only matters when two flags are
+ * true at once, which the UI makes hard to stage through the rendered drawer
+ * (each trigger disables itself while its own mutation runs).
+ */
+export declare const getBusyMessage: (state: {
+    isDeleting: boolean;
+    isReplacing: boolean;
+    isCropCopying: boolean;
+}) => {
+    id: string;
+    defaultMessage: string;
+} | null;
 interface AssetDetailsProps {
     asset: AssetWithPopulatedCreatedBy;
     closeDetails: () => void;

package/dist/admin/src/future/pages/Assets/components/AssetsSearchInput.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Keyword search over the whole Media Library. Owns the typing state and the
+ * debounce; `useAssetSearch` owns the `?_q=` URL param.
+ */
+export declare const AssetsSearchInput: () => import("react/jsx-runtime").JSX.Element;

package/dist/admin/src/future/pages/Assets/components/BulkActionsBar.d.ts

@@ -1 +1,21 @@
-export declare const BulkActionsBar: () => import("react/jsx-runtime").JSX.Element | null;
+import { type ItemLocations } from '../../../utils/itemLocations';
+import type { File } from '../../../../../../shared/contracts/files';
+interface BulkActionsBarProps {
+    /**
+     * The assets currently rendered in the list, used to resolve the mime types
+     * of the selection — the bar needs them to know which selected assets the AI
+     * provider can actually read.
+     *
+     * Selection is page-scoped and cleared whenever the list identity changes, so
+     * every selected asset id is guaranteed to appear here.
+     */
+    assets?: File[];
+    /**
+     * Real location of every loaded row, so the move dialog validates each
+     * selected item against its own parent. Defaults to a lookup that misses
+     * everything, which falls back to the folder currently open.
+     */
+    locations?: ItemLocations;
+}
+export declare const BulkActionsBar: ({ assets, locations, }: BulkActionsBarProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/admin/src/future/pages/Assets/components/BulkMoveDialog.d.ts

@@ -1,13 +1,24 @@
+import type { DragItemData } from '../../../types/dnd';
 interface BulkMoveDialogProps {
     open: boolean;
     onClose: () => void;
+    /**
+     * Items to move, as drag data so destination validation sees each item's real
+     * parent — the current folder is not a reliable stand-in once results come
+     * from a global search.
+     */
+    items: DragItemData[];
+    onSuccess?: () => void;
 }
 /**
- * "Move elements to" modal for the bulk actions bar. Moves the current
- * selection (assets and/or folders) into the picked destination folder via
- * `POST /upload/actions/bulk-move`. The mutation invalidates the asset list,
- * folder list and the sidebar folder-structure, so both panes refresh on
- * success. On failure the modal stays open so the user can retry or cancel.
+ * "Move elements to" modal. Moves the given items (assets and/or folders) into
+ * the picked destination folder via `POST /upload/actions/bulk-move`. The
+ * mutation invalidates the asset list, folder list and the sidebar
+ * folder-structure, so both panes refresh on success. On failure the modal stays
+ * open so the user can retry or cancel.
+ *
+ * Used both by the bulk actions bar (the whole selection) and by a folder's
+ * actions menu (that one folder).
  */
-export declare const BulkMoveDialog: ({ open, onClose }: BulkMoveDialogProps) => import("react/jsx-runtime").JSX.Element;
+export declare const BulkMoveDialog: ({ open, onClose, items, onSuccess }: BulkMoveDialogProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/admin/src/future/pages/Assets/components/BusyOverlay.d.ts

@@ -0,0 +1,9 @@
+interface BusyOverlayProps {
+    /** Shown next to the spinner, and read out as the loader's accessible label. */
+    children: string;
+    zIndex?: number;
+    /** Hides the label, leaving the spinner — for containers too small to fit text. */
+    hideLabel?: boolean;
+}
+export declare const BusyOverlay: ({ children, zIndex, hideLabel }: BusyOverlayProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/future/pages/Assets/components/DateRangeCalendar.d.ts

@@ -0,0 +1,8 @@
+interface DateRangeCalendarProps {
+    /** `YYYY-MM-DD`, both set when editing an existing range badge. */
+    from?: string;
+    to?: string;
+    onSelect: (from: string, to: string) => void;
+}
+export declare const DateRangeCalendar: ({ from, to, onSelect }: DateRangeCalendarProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/future/pages/Assets/components/DeleteItemsDialog.d.ts

@@ -0,0 +1,27 @@
+interface DeleteItemsDialogProps {
+    open: boolean;
+    onClose: () => void;
+    /** Explicit delete target — assets and/or folders, by id. */
+    target: {
+        fileIds: number[];
+        folderIds: number[];
+    };
+    /** Called after a successful delete, before the toast. */
+    onSuccess?: () => void;
+    /**
+     * Mirrors the in-flight state out to the caller, so a host that has its own
+     * controls (the bulk actions bar) can disable them for the duration.
+     */
+    onPendingChange?: (pending: boolean) => void;
+}
+/**
+ * Confirm dialog for `POST /upload/actions/bulk-delete`. Fully controlled: the
+ * caller owns `open` and renders its own trigger. Shared by the bulk actions bar
+ * (selection-scoped) and the per-folder actions menu (item-scoped), so the
+ * target is always passed in explicitly rather than read from the selection.
+ *
+ * Deleting a folder cascades server-side, which is why the copy warns about
+ * folder contents even for a single item.
+ */
+export declare const DeleteItemsDialog: ({ open, onClose, target, onSuccess, onPendingChange, }: DeleteItemsDialogProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/future/pages/Assets/components/Dnd/AssetsDndProvider.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+import { type ItemLocations } from '../../../../utils/itemLocations';
 interface AssetsDndContextValue {
     isInternalDragActive: boolean;
     isMovePending: boolean;
@@ -9,6 +10,12 @@ export declare const useAssetsDnd: () => AssetsDndContextValue;
 export declare const useAssetsDndOptional: () => AssetsDndContextValue | null;
 interface AssetsDndProviderProps {
     children: ReactNode;
+    /**
+     * Real location of every loaded row, so a multi-item drag validates against
+     * each item's own parent. Defaults to a lookup that misses everything, which
+     * falls back to the folder currently open.
+     */
+    locations?: ItemLocations;
 }
-export declare const AssetsDndProvider: ({ children }: AssetsDndProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const AssetsDndProvider: ({ children, locations, }: AssetsDndProviderProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/admin/src/future/pages/Assets/components/Dnd/buildDragSet.d.ts

@@ -1,9 +1,22 @@
+import { type ItemLocations } from '../../../../utils/itemLocations';
 import { type ItemKey } from '../../utils/selection';
 import type { DragItemData } from '../../../../types/dnd';
 export interface DragSet {
     items: DragItemData[];
     /** True when the active item was already selected — membership is the full selection. */
     fromSelection: boolean;
+    /**
+     * Location of the row the user actually grabbed — the only item in the set
+     * whose origin the user can point at. Names the source in the success toast.
+     */
+    activeSourceFolderId: number | null;
+    /**
+     * True when the set spans more than one source folder, which a global search
+     * selection can. There is then no single source to name, so the toast has to
+     * drop it rather than pick one item's folder and imply the others came from
+     * there too.
+     */
+    spansMultipleSources: boolean;
 }
 /**
  * Derive the drag payload once at drag start.
@@ -11,7 +24,9 @@ export interface DragSet {
  * - Dragging a selected item moves the complete current selection.
  * - Dragging an unselected item moves only that item.
  *
- * Selection is page-scoped to the current folder, so every item is stamped with
- * `currentFolderId` as its location for move validation.
+ * The active item carries its own location on `dragData` (the row it was
+ * grabbed from); the rest of the selection is resolved through `locations`.
+ * Neither is derived from the folder currently open, because search results are
+ * global — see `utils/itemLocations.ts`.
  */
-export declare const buildDragSet: (activeData: DragItemData, selectedKeys: Set<ItemKey> | undefined, currentFolderId: number | null) => DragSet;
+export declare const buildDragSet: (activeData: DragItemData, selectedKeys: Set<ItemKey> | undefined, locations: ItemLocations, fallbackFolderId: number | null) => DragSet;

package/dist/admin/src/future/pages/Assets/components/Dnd/useAssetDnd.d.ts

@@ -1,4 +1,4 @@
-import type { DragFolderData } from '../../../../types/dnd';
+import type { DragFileData, DragFolderData } from '../../../../types/dnd';
 export declare const useFileDraggable: (asset: {
     id: number;
     name: string;
@@ -6,6 +6,7 @@ export declare const useFileDraggable: (asset: {
         id?: number;
     } | null;
 }) => {
+    dragData: DragFileData;
     active: import("@dnd-kit/core").Active | null;
     activatorEvent: Event | null;
     activeNodeRect: import("@dnd-kit/core").ClientRect | null;

package/dist/admin/src/future/pages/Assets/components/DropZone/UploadDropZoneContext.d.ts

@@ -3,8 +3,15 @@ type DropHandler = (files: File[]) => void | Promise<void>;
 interface UploadDropZoneProps {
     children: ReactNode;
     onDrop?: DropHandler;
+    /**
+     * When true, the zone never enters the dragging state and never fires
+     * `onDrop` — no overlay, no "drop here" invitation. Used to hide the whole
+     * upload affordance from users without `assets.create`, so they don't drag a
+     * file onto an inviting target that then silently discards it.
+     */
+    disabled?: boolean;
 }
-export declare const UploadDropZoneProvider: ({ children, onDrop }: UploadDropZoneProps) => import("react/jsx-runtime").JSX.Element;
+export declare const UploadDropZoneProvider: ({ children, onDrop, disabled, }: UploadDropZoneProps) => import("react/jsx-runtime").JSX.Element;
 export declare const useUploadDropZone: () => {
     isDragging: boolean;
 };

package/dist/admin/src/future/pages/Assets/components/EmptyState.d.ts

@@ -1,5 +1,13 @@
 interface EmptyStateProps {
     onAddAssets: () => void;
+    /**
+     * RBAC gate — without `assets.create` the "Add assets" CTA is hidden.
+     * Required (not defaulted) so a permission gate can't silently regress to
+     * permissive when a future call site forgets to pass it.
+     */
+    canAddAssets: boolean;
+    searchQuery?: string;
+    onClearSearch?: () => void;
 }
 /**
  * Empty state for the assets list (both views) when the current folder holds
@@ -7,5 +15,14 @@ interface EmptyStateProps {
  * as New > File upload; drag-and-drop upload keeps working since the page-wide
  * drop zone wraps this component.
  */
-export declare const EmptyState: ({ onAddAssets }: EmptyStateProps) => import("react/jsx-runtime").JSX.Element;
+export declare const EmptyState: ({ onAddAssets, canAddAssets, searchQuery, onClearSearch, }: EmptyStateProps) => import("react/jsx-runtime").JSX.Element;
+interface FilteredEmptyStateProps {
+    onClearFilters: () => void;
+}
+/**
+ * Empty state when active filters match nothing (including contradictory
+ * badges — allowed by design). Distinct from the no-content state: the library
+ * has items, the filters exclude them all.
+ */
+export declare const FilteredEmptyState: ({ onClearFilters }: FilteredEmptyStateProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/admin/src/future/pages/Assets/components/FilterBadges.d.ts

@@ -0,0 +1,8 @@
+import { type ListFilters } from '../hooks/useListFilters';
+interface FilterBadgesProps {
+    listFilters: ListFilters;
+    /** Sticky header is scrolled/compact — reduce the space above the badges. */
+    compact?: boolean;
+}
+export declare const FilterBadges: ({ listFilters, compact }: FilterBadgesProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/admin/src/future/pages/Assets/components/FilterMenu.d.ts

@@ -0,0 +1,26 @@
+import { type DateField, type DatePreset, type ListFilters, type TypeValue } from '../hooks/useListFilters';
+import type { MessageDescriptor } from 'react-intl';
+export declare const TYPE_LABELS: Record<TypeValue, MessageDescriptor>;
+export declare const PRESET_LABELS: Record<DatePreset, MessageDescriptor>;
+export declare const DATE_FIELD_LABELS: Record<DateField, MessageDescriptor>;
+/** Every panel of the filter tree shares this fixed width (design). */
+export declare const FILTER_PANEL_WIDTH = "24.2rem";
+interface FilterMenuProps {
+    listFilters: ListFilters;
+}
+/**
+ * Toolbar "Filter" dropdown. Picking anything ADDS a badge (editing happens on
+ * the badge itself, see FilterBadges):
+ *
+ * - Type → keep-open checkbox list; the badge is created/updated live with the
+ *   checked set (`is` by default, condition editable on the badge).
+ * - Creation date / Last modified → preset list (single pick, `within the
+ *   last` by default) + "Select date range" (creation date only) opening the
+ *   range calendar; a completed range adds an `is` range badge.
+ *
+ * Closing behaviour follows how many values a field can hold: a date is one
+ * value, so picking a preset (or committing a range) closes the menu; Type is a
+ * set, so it stays open until dismissed.
+ */
+export declare const FilterMenu: ({ listFilters }: FilterMenuProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/future/pages/Assets/components/FolderActionsMenu.d.ts

@@ -0,0 +1,20 @@
+import type { Folder } from '../../../../../../shared/contracts/folders';
+import type { DragFolderData } from '../../../types/dnd';
+interface FolderActionsMenuProps {
+    folder: Folder;
+    /** Drag data for this folder, so the move dialog validates against its real parent. */
+    dragData: DragFolderData;
+}
+/**
+ * The "..." menu on a folder row/card. Always acts on that one folder, whatever
+ * the current multi-selection is (the bulk actions bar is the selection-scoped
+ * affordance). It reuses the shared move and delete dialogs, which mount only
+ * while open.
+ *
+ * A successful move or delete clears the whole selection: they only invalidate
+ * RTK tags, so without it a `folder:<id>` key for a folder that no longer lives
+ * where the selection thinks it does would linger. A rename leaves the id
+ * valid, so it deliberately keeps the selection.
+ */
+export declare const FolderActionsMenu: ({ folder, dragData }: FolderActionsMenuProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/future/pages/Assets/components/FolderFormDialog.d.ts

@@ -0,0 +1,16 @@
+interface FolderFormDialogBaseProps {
+    open: boolean;
+    onClose: () => void;
+    /** Sent as `parent`. Create: the folder being created in. Rename: the folder's existing parent. */
+    parentFolderId: number | null;
+}
+type FolderFormDialogProps = FolderFormDialogBaseProps & ({
+    mode: 'create';
+    parentFolderName: string;
+} | {
+    mode: 'rename';
+    folderId: number;
+    initialName: string;
+});
+export declare const FolderFormDialog: (props: FolderFormDialogProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/admin/src/future/pages/Assets/components/FolderTree/FolderTree.d.ts

@@ -1,5 +1,10 @@
 interface FolderTreeProps {
     currentFolderId: number | null;
+    /**
+     * Set to `false` while a global asset search is active: the results span the
+     * whole library, so highlighting one folder would misrepresent them.
+     * */
+    showActiveFolder?: boolean;
     onSelectFolder: (folderId: number | null) => void;
 }
 /**
@@ -7,13 +12,17 @@ interface FolderTreeProps {
  * and renders:
  *
  * 1. A "Media library" title
- * 2. A "Home" entry that clears the folder query param
- * 3. A "FOLDERS" section header
- * 4. The folder tree itself
+ * 2. A filter input that prunes the tree to matching destinations
+ * 3. A "Home" entry that clears the folder query param
+ * 4. A "FOLDERS" section header
+ * 5. The folder tree itself
+ *
+ * The filter is purely local: it never touches the URL and never affects the
+ * asset list, which has its own independent search in the content toolbar.
  *
  * Presentational with respect to routing — navigation is delegated to the parent
  * via `onSelectFolder` so the URL stays the single source of truth (see
  * `useFolderNavigation`).
  */
-export declare const FolderTree: ({ currentFolderId, onSelectFolder }: FolderTreeProps) => import("react/jsx-runtime").JSX.Element;
+export declare const FolderTree: ({ currentFolderId, showActiveFolder, onSelectFolder, }: FolderTreeProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/admin/src/future/pages/Assets/components/SortMenu.d.ts

@@ -12,6 +12,12 @@ interface SortMenuProps {
  * option keeps the menu open (`onSelect` preventDefault) so several facets can
  * be tuned in one visit; clicking a checked facet clears it (the hook
  * guarantees at least one sort rule stays active).
+ *
+ * Each section is single-select, so its items are radios: the checkmark icon is
+ * decorative, and `aria-checked` is what assistive tech reads. The DS `Menu`
+ * exposes no `RadioItem`, but `Menu.Item` forwards extra props onto the element
+ * it renders through Radix's `asChild`, where they take precedence over Radix's
+ * own `role="menuitem"`.
  */
 export declare const SortMenu: ({ sort, showFoldersGroup }: SortMenuProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -0,0 +1,12 @@
+/**
+ * Reads and writes the global asset search term held in `?_q=`.
+ *
+ * Debouncing is the input component's job (see `AssetsSearchInput`) — this hook
+ * is a thin URL accessor so every consumer reads the same source of truth.
+ */
+export declare const useAssetSearch: () => {
+    searchQuery: string;
+    isSearching: boolean;
+    setSearchQuery: (value: string) => void;
+    clearSearch: () => void;
+};

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

@@ -32,8 +32,15 @@ export interface AssetSelection {
 }
 interface AssetSelectionProviderProps {
     children: ReactNode;
+    /**
+     * When true, selection is inert: every mutator is a no-op and nothing ever
+     * reads as selected. Every bulk action is gated on `assets.update`, so a user
+     * without it has nothing to select for — the views also hide the checkboxes,
+     * and this makes the remaining paths (click-to-select, Space key) do nothing.
+     */
+    disabled?: boolean;
 }
-export declare const AssetSelectionProvider: ({ children }: AssetSelectionProviderProps) => import("react").FunctionComponentElement<import("react").ProviderProps<AssetSelection | null>>;
+export declare const AssetSelectionProvider: ({ children, disabled, }: AssetSelectionProviderProps) => import("react").FunctionComponentElement<import("react").ProviderProps<AssetSelection | null>>;
 export declare const useAssetSelection: () => AssetSelection;
 export declare const useAssetSelectionOptional: () => AssetSelection | null;
 export {};

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

@@ -0,0 +1,38 @@
+import type { ReactNode } from 'react';
+/**
+ * Which assets have a long-running mutation in flight, so the list can show it
+ * on the item itself.
+ *
+ * The mutation stays where it is triggered — the row's "..." menu — but the
+ * feedback has to render on the row or card, which is an ancestor of it. The
+ * menu sits in a leaf `<td>` (table) / footer `Flex` (grid), so an overlay
+ * mounted there would cover the button and nothing else. Rather than hoist the
+ * mutation up into both `AssetRow` and `AssetCard` (duplicating it, and moving
+ * it away from the control that owns it), the busy flag travels up through
+ * context and the ancestor renders the overlay.
+ *
+ * Scoped per asset id rather than a single boolean: a replace on one row must
+ * not blank out every other row. Modelled on `isMovePending` in
+ * `AssetsDndProvider`, which does the same thing for drag-moves — that one is
+ * list-wide because a move genuinely blocks the whole list.
+ */
+export interface BusyAssets {
+    /** Whether this asset has a mutation in flight. */
+    isBusy: (id: number) => boolean;
+    /** The message to show while it is, or `null`. */
+    getBusyMessage: (id: number) => string | null;
+    /**
+     * Marks the asset busy and returns the release function. Pair it with
+     * `try`/`finally` so the flag clears on failure too.
+     */
+    markBusy: (id: number, message: string) => () => void;
+}
+export declare const BusyAssetsProvider: ({ children }: {
+    children: ReactNode;
+}) => import("react").FunctionComponentElement<import("react").ProviderProps<BusyAssets | null>>;
+/**
+ * Optional by design: `AssetActionsMenu`, `AssetRow` and `AssetCard` are also
+ * rendered in tests and in the asset picker, outside this provider. Without it
+ * the mutation still runs, it just shows no row-level feedback.
+ */
+export declare const useBusyAssetsOptional: () => BusyAssets | null;