@anvilkit/plugin-asset-manager 0.1.5 → 0.1.7

package/dist/types/unsplash.d.cts

@@ -0,0 +1,60 @@
+/**
+ * @file Unsplash configuration types (PRD 0002 §8.2, §8.3).
+ *
+ * Types only — the runtime client, default themes, and `resolveThemes` land in
+ * Phase 1 under the lazy `./sources/unsplash` subpath. Defining the config shape
+ * here keeps the `AssetManagerOptions.unsplash` field fully typed now.
+ */
+export interface UnsplashTheme {
+    readonly id: string;
+    /** i18n message key (not inline copy). */
+    readonly label: string;
+    /** Tried first via `GET /topics/:id/photos`. */
+    readonly topicSlugs?: readonly string[];
+    /** Fallback / supplement via `GET /search/photos`. */
+    readonly query?: string;
+    readonly orientation?: "landscape" | "portrait" | "squarish";
+    /** Defaults to `"high"`. */
+    readonly contentFilter?: "low" | "high";
+}
+export interface UnsplashThemeConfig {
+    /** Replace the default theme set entirely. */
+    readonly themes?: readonly UnsplashTheme[];
+    /** Append to the defaults. */
+    readonly additionalThemes?: readonly UnsplashTheme[];
+    /** Theme ids to drop from the defaults. */
+    readonly excludeThemes?: readonly string[];
+    readonly defaultThemeId?: string;
+    /** When `false`, the `__all__` free-search pseudo-theme is not prepended. */
+    readonly allowFreeSearch?: boolean;
+}
+export interface UnsplashSourceOptions {
+    /** RECOMMENDED — proxy injects the `Client-ID` server-side. */
+    readonly proxyEndpoint?: string | URL;
+    /** DEV ONLY — ships the key to the browser; ignored when `proxyEndpoint` is set. */
+    readonly accessKey?: string;
+    /** Defaults to `!!(proxyEndpoint || accessKey)`; the package never bundles a key. */
+    readonly enabled?: boolean;
+    /** REQUIRED when enabled — `utm_source` for mandatory attribution. */
+    readonly appName: string;
+    readonly themes?: UnsplashThemeConfig;
+    /** Default 24 (clamped 1–30). */
+    readonly perPage?: number;
+    /** Throttle floor between JSON requests. Default 1200. */
+    readonly minRequestIntervalMs?: number;
+    /** Result LRU TTL. Default 300_000. */
+    readonly cacheTtlMs?: number;
+    /**
+     * Per-request timeout for search / topic / photo lookups (ms). A request
+     * that exceeds it aborts and surfaces as a retryable `PROVIDER_NETWORK`
+     * error, so a blocked or flaky network path (e.g. a VPN/proxy black-holing
+     * `api.unsplash.com`) lets the sidebar fall back to "Unsplash unavailable"
+     * instead of spinning. Default 15_000. Ignored if not a positive number.
+     */
+    readonly requestTimeoutMs?: number;
+    /** Injectable fetch for tests / SSR. */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Opt-in re-host instead of hotlinking. Default false. */
+    readonly rehostOnPick?: boolean;
+}
+//# sourceMappingURL=unsplash.d.cts.map

package/dist/types/unsplash.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsplash.d.cts","sourceRoot":"","sources":["../../src/types/unsplash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,4BAA4B;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACrD,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/types/unsplash.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @file Unsplash configuration types (PRD 0002 §8.2, §8.3).
+ *
+ * Types only — the runtime client, default themes, and `resolveThemes` land in
+ * Phase 1 under the lazy `./sources/unsplash` subpath. Defining the config shape
+ * here keeps the `AssetManagerOptions.unsplash` field fully typed now.
+ */
+export interface UnsplashTheme {
+    readonly id: string;
+    /** i18n message key (not inline copy). */
+    readonly label: string;
+    /** Tried first via `GET /topics/:id/photos`. */
+    readonly topicSlugs?: readonly string[];
+    /** Fallback / supplement via `GET /search/photos`. */
+    readonly query?: string;
+    readonly orientation?: "landscape" | "portrait" | "squarish";
+    /** Defaults to `"high"`. */
+    readonly contentFilter?: "low" | "high";
+}
+export interface UnsplashThemeConfig {
+    /** Replace the default theme set entirely. */
+    readonly themes?: readonly UnsplashTheme[];
+    /** Append to the defaults. */
+    readonly additionalThemes?: readonly UnsplashTheme[];
+    /** Theme ids to drop from the defaults. */
+    readonly excludeThemes?: readonly string[];
+    readonly defaultThemeId?: string;
+    /** When `false`, the `__all__` free-search pseudo-theme is not prepended. */
+    readonly allowFreeSearch?: boolean;
+}
+export interface UnsplashSourceOptions {
+    /** RECOMMENDED — proxy injects the `Client-ID` server-side. */
+    readonly proxyEndpoint?: string | URL;
+    /** DEV ONLY — ships the key to the browser; ignored when `proxyEndpoint` is set. */
+    readonly accessKey?: string;
+    /** Defaults to `!!(proxyEndpoint || accessKey)`; the package never bundles a key. */
+    readonly enabled?: boolean;
+    /** REQUIRED when enabled — `utm_source` for mandatory attribution. */
+    readonly appName: string;
+    readonly themes?: UnsplashThemeConfig;
+    /** Default 24 (clamped 1–30). */
+    readonly perPage?: number;
+    /** Throttle floor between JSON requests. Default 1200. */
+    readonly minRequestIntervalMs?: number;
+    /** Result LRU TTL. Default 300_000. */
+    readonly cacheTtlMs?: number;
+    /**
+     * Per-request timeout for search / topic / photo lookups (ms). A request
+     * that exceeds it aborts and surfaces as a retryable `PROVIDER_NETWORK`
+     * error, so a blocked or flaky network path (e.g. a VPN/proxy black-holing
+     * `api.unsplash.com`) lets the sidebar fall back to "Unsplash unavailable"
+     * instead of spinning. Default 15_000. Ignored if not a positive number.
+     */
+    readonly requestTimeoutMs?: number;
+    /** Injectable fetch for tests / SSR. */
+    readonly fetch?: typeof globalThis.fetch;
+    /** Opt-in re-host instead of hotlinking. Default false. */
+    readonly rehostOnPick?: boolean;
+}
+//# sourceMappingURL=unsplash.d.ts.map

package/dist/types/unsplash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unsplash.d.ts","sourceRoot":"","sources":["../../src/types/unsplash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;IAC7D,4BAA4B;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,8BAA8B;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACrD,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IACtC,oFAAoF;IACpF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,uCAAuC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wCAAwC;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/types/unsplash.js

@@ -0,0 +1 @@
+export { };

package/dist/ui/AssetBrowser.cjs

@@ -2,11 +2,15 @@
 "use client";
 var __webpack_require__ = {};
 (()=>{
-    __webpack_require__.d = (exports1, definition)=>{
-        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
-            enumerable: true,
-            get: definition[key]
-        });
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
     };
 })();
 (()=>{
@@ -27,11 +31,13 @@ __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
     AssetBrowser: ()=>AssetBrowser
 });
+const button_namespaceObject = require("@anvilkit/ui/button");
 const card_namespaceObject = require("@anvilkit/ui/card");
 const input_namespaceObject = require("@anvilkit/ui/input");
+const windowed_namespaceObject = require("@anvilkit/ui/windowed");
 const external_react_namespaceObject = require("react");
-const external_react_dom_namespaceObject = require("react-dom");
 const infer_kind_cjs_namespaceObject = require("../utils/infer-kind.cjs");
+const external_FolderTree_cjs_namespaceObject = require("./FolderTree.cjs");
 const KIND_FILTERS = [
     "image",
     "video",
@@ -43,20 +49,13 @@ const DEFAULT_VIRTUALIZE_THRESHOLD = 50;
 const DEFAULT_ITEM_HEIGHT = 56;
 const DEFAULT_MAX_HEIGHT = 400;
 const DEFAULT_PAGE_SIZE = 100;
-const OVERSCAN = 4;
-function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEnabled = false, pageSize = DEFAULT_PAGE_SIZE, virtualizeThreshold = DEFAULT_VIRTUALIZE_THRESHOLD, itemHeight = DEFAULT_ITEM_HEIGHT, maxHeight = DEFAULT_MAX_HEIGHT }) {
+function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEnabled = false, aboveFilters, draggableRows = false, pageSize = DEFAULT_PAGE_SIZE, virtualizeThreshold = DEFAULT_VIRTUALIZE_THRESHOLD, itemHeight = DEFAULT_ITEM_HEIGHT, maxHeight = DEFAULT_MAX_HEIGHT }) {
     const [activeIndex, setActiveIndex] = external_react_namespaceObject.useState(assets.length > 0 ? 0 : -1);
-    const [scrollTop, setScrollTop] = external_react_namespaceObject.useState(0);
     const [query, setQuery] = external_react_namespaceObject.useState("");
     const [activeKinds, setActiveKinds] = external_react_namespaceObject.useState([]);
     const [pageLimit, setPageLimit] = external_react_namespaceObject.useState(pageSize);
     const buttonRefs = external_react_namespaceObject.useRef([]);
-    const scrollContainerRef = external_react_namespaceObject.useRef(null);
-    const scrollFrameRef = external_react_namespaceObject.useRef(null);
-    const pendingScrollTopRef = external_react_namespaceObject.useRef(0);
-    external_react_namespaceObject.useEffect(()=>()=>{
-            if (null !== scrollFrameRef.current && "function" == typeof cancelAnimationFrame) cancelAnimationFrame(scrollFrameRef.current);
-        }, []);
+    const pendingFocusRef = external_react_namespaceObject.useRef(null);
     const searchIndex = external_react_namespaceObject.useMemo(()=>{
         if (!searchEnabled) return null;
         return assets.map((asset)=>({
@@ -96,7 +95,6 @@ function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEna
         searchEnabled
     ]);
     const total = visibleSlice.length;
-    const isVirtualized = total > virtualizeThreshold;
     const hasMore = searchEnabled && filteredAssets.length > visibleSlice.length;
     external_react_namespaceObject.useEffect(()=>{
         if (0 === total) return void setActiveIndex(-1);
@@ -104,31 +102,20 @@ function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEna
     }, [
         total
     ]);
+    function focusRow(index) {
+        const node = buttonRefs.current[index];
+        if (node) {
+            node.focus();
+            return true;
+        }
+        return false;
+    }
     function moveFocus(nextIndex) {
         if (0 === total) return;
         const clampedIndex = Math.max(0, Math.min(nextIndex, total - 1));
-        if (isVirtualized && scrollContainerRef.current) {
-            const targetTop = clampedIndex * itemHeight;
-            const targetBottom = targetTop + itemHeight;
-            const viewTop = scrollContainerRef.current.scrollTop;
-            let nextScrollTop = viewTop;
-            if (targetTop < viewTop) nextScrollTop = targetTop;
-            else if (targetBottom > viewTop + maxHeight) nextScrollTop = targetBottom - maxHeight;
-            if (null !== scrollFrameRef.current && "function" == typeof cancelAnimationFrame) {
-                cancelAnimationFrame(scrollFrameRef.current);
-                scrollFrameRef.current = null;
-            }
-            pendingScrollTopRef.current = nextScrollTop;
-            (0, external_react_dom_namespaceObject.flushSync)(()=>{
-                setActiveIndex(clampedIndex);
-                setScrollTop(nextScrollTop);
-            });
-            scrollContainerRef.current.scrollTop = nextScrollTop;
-            buttonRefs.current[clampedIndex]?.focus();
-            return;
-        }
+        pendingFocusRef.current = clampedIndex;
         setActiveIndex(clampedIndex);
-        buttonRefs.current[clampedIndex]?.focus();
+        if (focusRow(clampedIndex)) pendingFocusRef.current = null;
     }
     function toggleKind(kind) {
         setActiveKinds((current)=>current.includes(kind) ? current.filter((entry)=>entry !== kind) : [
@@ -136,17 +123,16 @@ function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEna
                 kind
             ]);
     }
-    const firstVisible = isVirtualized ? Math.max(0, Math.floor(scrollTop / itemHeight) - OVERSCAN) : 0;
-    const lastVisible = isVirtualized ? Math.min(total - 1, Math.ceil((scrollTop + maxHeight) / itemHeight) + OVERSCAN) : total - 1;
-    const visibleAssets = 0 === total ? [] : isVirtualized ? visibleSlice.slice(firstVisible, lastVisible + 1) : visibleSlice;
-    function renderRow(asset, index) {
-        return /*#__PURE__*/ external_react_namespaceObject.createElement("li", {
-            "aria-posinset": index + 1,
-            "aria-setsize": total,
-            key: asset.id,
-            role: "listitem"
-        }, /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
+    const renderRow = (asset, index)=>/*#__PURE__*/ external_react_namespaceObject.createElement(external_react_namespaceObject.Fragment, null, /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
             "aria-label": `Insert asset ${asset.id}`,
+            draggable: draggableRows,
+            "data-asset-draggable": draggableRows ? "" : void 0,
+            onDragStart: draggableRows ? (event)=>{
+                event.dataTransfer.setData(external_FolderTree_cjs_namespaceObject.ASSET_DRAG_MIME, JSON.stringify([
+                    asset.id
+                ]));
+                event.dataTransfer.effectAllowed = "move";
+            } : void 0,
             onClick: ()=>{
                 onInsert(asset);
             },
@@ -181,33 +167,42 @@ function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEna
             },
             ref: (node)=>{
                 buttonRefs.current[index] = node;
+                if (node && pendingFocusRef.current === index) {
+                    pendingFocusRef.current = null;
+                    node.focus();
+                }
             },
             tabIndex: activeIndex === index ? 0 : -1,
             type: "button"
-        }, /*#__PURE__*/ external_react_namespaceObject.createElement("span", null, asset.id), /*#__PURE__*/ external_react_namespaceObject.createElement("span", null, asset.meta?.mimeType ?? "unknown type")), void 0 !== onEdit ? /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
+        }, /*#__PURE__*/ external_react_namespaceObject.createElement("span", null, asset.id), /*#__PURE__*/ external_react_namespaceObject.createElement("span", null, asset.meta?.mimeType ?? "unknown type")), void 0 !== onEdit ? /*#__PURE__*/ external_react_namespaceObject.createElement(button_namespaceObject.Button, {
             "aria-label": `Edit asset ${asset.id}`,
             "data-asset-action": "edit",
             onClick: ()=>{
                 onEdit(asset);
             },
-            type: "button"
-        }, "Edit") : null, void 0 !== onReplace ? /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
+            type: "button",
+            variant: "ghost",
+            size: "sm"
+        }, "Edit") : null, void 0 !== onReplace ? /*#__PURE__*/ external_react_namespaceObject.createElement(button_namespaceObject.Button, {
             "aria-label": `Replace asset ${asset.id}`,
             "data-asset-action": "replace",
             onClick: ()=>{
                 onReplace(asset);
             },
-            type: "button"
-        }, "Replace") : null, void 0 !== onDelete ? /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
+            type: "button",
+            variant: "ghost",
+            size: "sm"
+        }, "Replace") : null, void 0 !== onDelete ? /*#__PURE__*/ external_react_namespaceObject.createElement(button_namespaceObject.Button, {
             "aria-label": `Delete asset ${asset.id}`,
             "data-asset-action": "delete",
             onClick: ()=>{
                 onDelete(asset);
             },
-            type: "button"
+            type: "button",
+            variant: "ghost",
+            size: "sm"
         }, "Delete") : null);
-    }
-    const filterRow = searchEnabled ? /*#__PURE__*/ external_react_namespaceObject.createElement("div", {
+    const searchRow = searchEnabled ? /*#__PURE__*/ external_react_namespaceObject.createElement("div", {
         "data-asset-manager-filters": true
     }, /*#__PURE__*/ external_react_namespaceObject.createElement(input_namespaceObject.Input, {
         "aria-label": "Search assets",
@@ -222,7 +217,7 @@ function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEna
         role: "group"
     }, KIND_FILTERS.map((kind)=>{
         const active = activeKinds.includes(kind);
-        return /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
+        return /*#__PURE__*/ external_react_namespaceObject.createElement(button_namespaceObject.Button, {
             "aria-label": `Filter ${kind} assets`,
             "aria-pressed": active,
             "data-asset-kind-filter": kind,
@@ -231,9 +226,12 @@ function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEna
                 toggleKind(kind);
                 setPageLimit(pageSize);
             },
-            type: "button"
+            type: "button",
+            variant: active ? "secondary" : "ghost",
+            size: "sm"
         }, kind);
     }))) : null;
+    const filterRow = /*#__PURE__*/ external_react_namespaceObject.createElement(external_react_namespaceObject.Fragment, null, aboveFilters, searchRow);
     if (0 === total) {
         const emptyLabel = searchEnabled && ("" !== query || activeKinds.length > 0) ? "No assets match the current filters." : "No assets uploaded yet.";
         return /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.Card, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardHeader, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardTitle, null, "Asset browser"), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardDescription, null, "Validated assets currently registered in memory.")), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardContent, null, filterRow, /*#__PURE__*/ external_react_namespaceObject.createElement("ul", {
@@ -243,58 +241,25 @@ function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEna
             role: "listitem"
         }, emptyLabel))));
     }
-    if (!isVirtualized) return /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.Card, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardHeader, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardTitle, null, "Asset browser"), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardDescription, null, "Validated assets currently registered in memory.")), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardContent, null, filterRow, /*#__PURE__*/ external_react_namespaceObject.createElement("ul", {
-        "aria-label": "Assets",
-        role: "list"
-    }, visibleAssets.map((asset, offset)=>renderRow(asset, offset))), hasMore ? /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
-        "data-asset-action": "load-more",
-        onClick: ()=>{
-            setPageLimit((current)=>current + pageSize);
-        },
-        type: "button"
-    }, "Load more") : null));
-    const totalHeight = total * itemHeight;
-    const offsetY = firstVisible * itemHeight;
-    return /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.Card, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardHeader, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardTitle, null, "Asset browser"), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardDescription, null, "Validated assets currently registered in memory.")), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardContent, null, filterRow, /*#__PURE__*/ external_react_namespaceObject.createElement("div", {
-        "data-asset-manager-virtual": true,
-        onScroll: (event)=>{
-            const next = event.currentTarget.scrollTop;
-            if ("function" != typeof requestAnimationFrame) return void setScrollTop(next);
-            pendingScrollTopRef.current = next;
-            if (null !== scrollFrameRef.current) return;
-            scrollFrameRef.current = requestAnimationFrame(()=>{
-                scrollFrameRef.current = null;
-                setScrollTop(pendingScrollTopRef.current);
-            });
-        },
-        ref: scrollContainerRef,
-        style: {
-            height: maxHeight,
-            overflowY: "auto",
-            position: "relative"
-        }
-    }, /*#__PURE__*/ external_react_namespaceObject.createElement("div", {
-        style: {
-            height: totalHeight,
-            position: "relative"
-        }
-    }, /*#__PURE__*/ external_react_namespaceObject.createElement("ul", {
+    return /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.Card, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardHeader, null, /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardTitle, null, "Asset browser"), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardDescription, null, "Validated assets currently registered in memory.")), /*#__PURE__*/ external_react_namespaceObject.createElement(card_namespaceObject.CardContent, null, filterRow, /*#__PURE__*/ external_react_namespaceObject.createElement(windowed_namespaceObject.Windowed, {
+        activeIndex: activeIndex >= 0 ? activeIndex : void 0,
         "aria-label": "Assets",
-        role: "list",
-        style: {
-            margin: 0,
-            padding: 0,
-            position: "absolute",
-            top: offsetY,
-            left: 0,
-            right: 0
-        }
-    }, visibleAssets.map((asset, offset)=>renderRow(asset, firstVisible + offset))))), hasMore ? /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
+        as: "ul",
+        "data-testid": "asset-browser-virtualized",
+        estimateSize: itemHeight,
+        items: visibleSlice,
+        itemKey: (asset)=>asset.id,
+        maxHeight: maxHeight,
+        renderItem: renderRow,
+        threshold: virtualizeThreshold
+    }), hasMore ? /*#__PURE__*/ external_react_namespaceObject.createElement(button_namespaceObject.Button, {
         "data-asset-action": "load-more",
         onClick: ()=>{
             setPageLimit((current)=>current + pageSize);
         },
-        type: "button"
+        type: "button",
+        variant: "outline",
+        size: "sm"
     }, "Load more") : null));
 }
 exports.AssetBrowser = __webpack_exports__.AssetBrowser;

package/dist/ui/AssetBrowser.d.cts

@@ -1,3 +1,4 @@
+import * as React from "react";
 import type { UploadResult } from "../types/types.js";
 export interface AssetBrowserProps {
     readonly assets: readonly UploadResult[];
@@ -25,6 +26,16 @@ export interface AssetBrowserProps {
      * pre-filter at the host layer) keep their previous chrome.
      */
     readonly searchEnabled?: boolean;
+    /**
+     * Optional content rendered above the filter row — typically a folder
+     * breadcrumb + tree + source tabs (PRD 0002 §7.4). Purely additive.
+     */
+    readonly aboveFilters?: React.ReactNode;
+    /**
+     * When `true`, asset rows are draggable carrying an asset-id payload
+     * (`ASSET_DRAG_MIME`) so they can be dropped onto a `FolderTree` row.
+     */
+    readonly draggableRows?: boolean;
     /**
      * Page size used by the "Load more" affordance once the visible
      * slice exceeds this number. Defaults to 100.
@@ -33,22 +44,21 @@ export interface AssetBrowserProps {
     /**
      * Threshold above which the list windows visible items. Below the
      * threshold the entire list renders inline so small libraries skip
-     * scroll math entirely.
+     * scroll math entirely. Forwarded to the shared `Windowed` primitive.
      */
     readonly virtualizeThreshold?: number;
     /**
      * Pixel height of a single row when virtualizing.
      *
-     * **Fixed-height contract:** the windowing math (visible range, scroll
-     * offset, and keyboard-focus scroll) assumes every row is exactly
-     * `itemHeight` tall. Rows that wrap or vary in height (long names,
-     * thumbnails) will desync the scroll position and focus calculation.
-     * Keep rows uniform, or raise `virtualizeThreshold` so the list renders
+     * **Fixed-height contract:** the windowing math assumes every row is
+     * roughly `itemHeight` tall. Rows that wrap or vary in height (long
+     * names, thumbnails) will desync the scroll-into-view calculation. Keep
+     * rows uniform, or raise `virtualizeThreshold` so the list renders
      * inline instead.
      */
     readonly itemHeight?: number;
     /** Pixel height of the scroll container when virtualizing. */
     readonly maxHeight?: number;
 }
-export declare function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEnabled, pageSize, virtualizeThreshold, itemHeight, maxHeight, }: AssetBrowserProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEnabled, aboveFilters, draggableRows, pageSize, virtualizeThreshold, itemHeight, maxHeight, }: AssetBrowserProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AssetBrowser.d.cts.map

package/dist/ui/AssetBrowser.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetBrowser.d.cts","sourceRoot":"","sources":["../../src/ui/AssetBrowser.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWjE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,wBAAgB,YAAY,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAqB,EACrB,QAA4B,EAC5B,mBAAkD,EAClD,UAAgC,EAChC,SAA8B,GAC9B,EAAE,iBAAiB,2CAkZnB"}
+{"version":3,"file":"AssetBrowser.d.cts","sourceRoot":"","sources":["../../src/ui/AssetBrowser.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYjE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAOD,wBAAgB,YAAY,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAqB,EACrB,YAAY,EACZ,aAAqB,EACrB,QAA4B,EAC5B,mBAAkD,EAClD,UAAgC,EAChC,SAA8B,GAC9B,EAAE,iBAAiB,2CAqUnB"}

package/dist/ui/AssetBrowser.d.ts

@@ -1,3 +1,4 @@
+import * as React from "react";
 import type { UploadResult } from "../types/types.js";
 export interface AssetBrowserProps {
     readonly assets: readonly UploadResult[];
@@ -25,6 +26,16 @@ export interface AssetBrowserProps {
      * pre-filter at the host layer) keep their previous chrome.
      */
     readonly searchEnabled?: boolean;
+    /**
+     * Optional content rendered above the filter row — typically a folder
+     * breadcrumb + tree + source tabs (PRD 0002 §7.4). Purely additive.
+     */
+    readonly aboveFilters?: React.ReactNode;
+    /**
+     * When `true`, asset rows are draggable carrying an asset-id payload
+     * (`ASSET_DRAG_MIME`) so they can be dropped onto a `FolderTree` row.
+     */
+    readonly draggableRows?: boolean;
     /**
      * Page size used by the "Load more" affordance once the visible
      * slice exceeds this number. Defaults to 100.
@@ -33,22 +44,21 @@ export interface AssetBrowserProps {
     /**
      * Threshold above which the list windows visible items. Below the
      * threshold the entire list renders inline so small libraries skip
-     * scroll math entirely.
+     * scroll math entirely. Forwarded to the shared `Windowed` primitive.
      */
     readonly virtualizeThreshold?: number;
     /**
      * Pixel height of a single row when virtualizing.
      *
-     * **Fixed-height contract:** the windowing math (visible range, scroll
-     * offset, and keyboard-focus scroll) assumes every row is exactly
-     * `itemHeight` tall. Rows that wrap or vary in height (long names,
-     * thumbnails) will desync the scroll position and focus calculation.
-     * Keep rows uniform, or raise `virtualizeThreshold` so the list renders
+     * **Fixed-height contract:** the windowing math assumes every row is
+     * roughly `itemHeight` tall. Rows that wrap or vary in height (long
+     * names, thumbnails) will desync the scroll-into-view calculation. Keep
+     * rows uniform, or raise `virtualizeThreshold` so the list renders
      * inline instead.
      */
     readonly itemHeight?: number;
     /** Pixel height of the scroll container when virtualizing. */
     readonly maxHeight?: number;
 }
-export declare function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEnabled, pageSize, virtualizeThreshold, itemHeight, maxHeight, }: AssetBrowserProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssetBrowser({ assets, onInsert, onDelete, onReplace, onEdit, searchEnabled, aboveFilters, draggableRows, pageSize, virtualizeThreshold, itemHeight, maxHeight, }: AssetBrowserProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=AssetBrowser.d.ts.map

package/dist/ui/AssetBrowser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssetBrowser.d.ts","sourceRoot":"","sources":["../../src/ui/AssetBrowser.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAWjE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;;;;;OASG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAQD,wBAAgB,YAAY,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAqB,EACrB,QAA4B,EAC5B,mBAAkD,EAClD,UAAgC,EAChC,SAA8B,GAC9B,EAAE,iBAAiB,2CAkZnB"}
+{"version":3,"file":"AssetBrowser.d.ts","sourceRoot":"","sources":["../../src/ui/AssetBrowser.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAYjE,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAClD;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;AAOD,wBAAgB,YAAY,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,aAAqB,EACrB,YAAY,EACZ,aAAqB,EACrB,QAA4B,EAC5B,mBAAkD,EAClD,UAAgC,EAChC,SAA8B,GAC9B,EAAE,iBAAiB,2CAqUnB"}