@anvilkit/plugin-asset-manager 0.1.1

package/dist/types.d.cts

@@ -0,0 +1,132 @@
+export interface AssetMeta {
+    readonly size?: number;
+    readonly mimeType?: string;
+    readonly width?: number;
+    readonly height?: number;
+}
+/**
+ * Library-management kind union surfaced by `AssetRegistry.search` and
+ * the sidebar filter row. Mirrors `@anvilkit/core/types`'
+ * `StudioAssetKind` shape so the same filter values flow through both
+ * the headless registry and the Studio surface without translation.
+ */
+export type AssetKind = "image" | "video" | "audio" | "font" | "document" | "other";
+export interface UploadResult {
+    readonly url: string;
+    readonly id: string;
+    /**
+     * Optional human-readable name. The plugin's `uploadAsset()` seeds
+     * this from the source `File`'s `name` so the sidebar can render a
+     * filename under each tile; uploader adapters may also populate it
+     * directly when they know a friendlier label.
+     */
+    readonly name?: string;
+    readonly meta?: AssetMeta;
+    /**
+     * Optional library tags. The plugin auto-derives a small set on
+     * register (kind + filename tokens); hosts may extend or replace via
+     * {@link AssetRegistry.setTags} or by attaching `tags` on a
+     * host-supplied `UploadResult`. Surfaced to the sidebar through
+     * `StudioAsset.tags` and consulted by `AssetRegistry.search`.
+     */
+    readonly tags?: readonly string[];
+}
+export type UploadAdapter = (file: File) => Promise<UploadResult>;
+export interface AssetManagerOptions {
+    readonly uploader: UploadAdapter;
+    readonly maxFileSize?: number;
+    readonly acceptedMimeTypes?: readonly string[];
+    /**
+     * Permit `data:` URLs to flow through the trust boundary. Defaults to
+     * `false` — `http`, `https`, and `blob` are always allowed; every
+     * other scheme is rejected. The previous `urlAllowlist: ["data"]`
+     * pattern is replaced by this typed flag in v1.0.
+     */
+    readonly dataUrlAllowlistOptIn?: boolean;
+    /**
+     * Permit `http(s)` URLs whose hostname mixes Unicode scripts (e.g.
+     * `аpple.com` blending Cyrillic and Latin). Defaults to `false` —
+     * mixed-script hostnames are rejected as a homoglyph-attack guard.
+     * Single-script IDN hosts (e.g. `münchen.de`, `日本.jp`) are always
+     * allowed regardless of this flag.
+     */
+    readonly allowMixedScriptHostnames?: boolean;
+    /**
+     * Optional thumbnail derivation passed to {@link createStudioAssetSource}.
+     * Returning a string sets `StudioAsset.thumbnailUrl`; returning
+     * `undefined` suppresses the thumbnail (overriding the default-for-images
+     * behavior).
+     */
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+}
+/**
+ * Listener invoked after every registry mutation
+ * (`register` / `delete` / `rename` / `replace` / `setTags`). The
+ * `studio-asset-source` adapter wires its own listener set onto the
+ * registry so the sidebar re-runs `list()` whenever an asset changes.
+ */
+export type AssetRegistryListener = () => void;
+/**
+ * Search and filter options accepted by {@link AssetRegistry.search}.
+ *
+ * `query` matches case-insensitively against `id`, `name`, `tags`, and
+ * the MIME type (prefix match — e.g. `"image"` matches `"image/png"`).
+ * Filters compose with AND semantics: an entry must satisfy every
+ * supplied filter to land in the page.
+ */
+export interface AssetSearchOptions {
+    readonly query?: string;
+    readonly kinds?: readonly AssetKind[];
+    readonly tags?: readonly string[];
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+/**
+ * Pagination envelope returned by {@link AssetRegistry.search}.
+ *
+ * - `items` — the slice for the requested page.
+ * - `total` — total number of matches across all pages (post-filter).
+ * - `nextCursor` — opaque cursor for the next page, or `undefined` when
+ *   the result set is exhausted.
+ */
+export interface AssetSearchPage {
+    readonly items: readonly UploadResult[];
+    readonly total: number;
+    readonly nextCursor: string | undefined;
+}
+export interface AssetRegistry {
+    readonly register: (asset: UploadResult) => UploadResult;
+    readonly get: (id: string) => UploadResult | undefined;
+    readonly list: () => readonly UploadResult[];
+    /** Remove an asset. Returns `true` if an entry was removed. */
+    readonly delete: (id: string) => boolean;
+    /**
+     * Rename an asset in-place. Returns the updated entry, or `undefined`
+     * if no asset with that id exists.
+     */
+    readonly rename: (id: string, name: string) => UploadResult | undefined;
+    /**
+     * Replace an asset in-place. Preserves the entry's `id` even if the
+     * incoming `next` carries a different one. Returns the updated entry,
+     * or `undefined` if no asset with that id exists.
+     */
+    readonly replace: (id: string, next: UploadResult) => UploadResult | undefined;
+    /**
+     * Replace the tag set on an asset in-place. Empty arrays drop the
+     * `tags` field entirely. Tags are deduped, trimmed, lowercased, and
+     * frozen before storage. Returns the updated entry, or `undefined`
+     * if no asset with that id exists.
+     */
+    readonly setTags: (id: string, tags: readonly string[]) => UploadResult | undefined;
+    /**
+     * Search and paginate the registry. See {@link AssetSearchOptions}
+     * for filter semantics.
+     */
+    readonly search: (options?: AssetSearchOptions) => AssetSearchPage;
+    /**
+     * Subscribe to mutation notifications. The returned function
+     * unsubscribes the listener.
+     */
+    readonly subscribe: (listener: AssetRegistryListener) => () => void;
+}
+//# sourceMappingURL=types.d.cts.map

package/dist/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAClB,OAAO,GACP,OAAO,GACP,OAAO,GACP,MAAM,GACN,UAAU,GACV,OAAO,CAAC;AAEX,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;AAElE,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IAC7C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;CACpE;AAED;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,IAAI,CAAC;AAE/C;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,YAAY,CAAC;IACzD,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,SAAS,YAAY,EAAE,CAAC;IAC7C,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,YAAY,GAAG,SAAS,CAAC;IACxE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,YAAY,KACd,YAAY,GAAG,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,CACjB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,SAAS,MAAM,EAAE,KACnB,YAAY,GAAG,SAAS,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,kBAAkB,KAAK,eAAe,CAAC;IACnE;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,qBAAqB,KAAK,MAAM,IAAI,CAAC;CACpE"}

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+export interface AssetMeta {
+    readonly size?: number;
+    readonly mimeType?: string;
+    readonly width?: number;
+    readonly height?: number;
+}
+/**
+ * Library-management kind union surfaced by `AssetRegistry.search` and
+ * the sidebar filter row. Mirrors `@anvilkit/core/types`'
+ * `StudioAssetKind` shape so the same filter values flow through both
+ * the headless registry and the Studio surface without translation.
+ */
+export type AssetKind = "image" | "video" | "audio" | "font" | "document" | "other";
+export interface UploadResult {
+    readonly url: string;
+    readonly id: string;
+    /**
+     * Optional human-readable name. The plugin's `uploadAsset()` seeds
+     * this from the source `File`'s `name` so the sidebar can render a
+     * filename under each tile; uploader adapters may also populate it
+     * directly when they know a friendlier label.
+     */
+    readonly name?: string;
+    readonly meta?: AssetMeta;
+    /**
+     * Optional library tags. The plugin auto-derives a small set on
+     * register (kind + filename tokens); hosts may extend or replace via
+     * {@link AssetRegistry.setTags} or by attaching `tags` on a
+     * host-supplied `UploadResult`. Surfaced to the sidebar through
+     * `StudioAsset.tags` and consulted by `AssetRegistry.search`.
+     */
+    readonly tags?: readonly string[];
+}
+export type UploadAdapter = (file: File) => Promise<UploadResult>;
+export interface AssetManagerOptions {
+    readonly uploader: UploadAdapter;
+    readonly maxFileSize?: number;
+    readonly acceptedMimeTypes?: readonly string[];
+    /**
+     * Permit `data:` URLs to flow through the trust boundary. Defaults to
+     * `false` — `http`, `https`, and `blob` are always allowed; every
+     * other scheme is rejected. The previous `urlAllowlist: ["data"]`
+     * pattern is replaced by this typed flag in v1.0.
+     */
+    readonly dataUrlAllowlistOptIn?: boolean;
+    /**
+     * Permit `http(s)` URLs whose hostname mixes Unicode scripts (e.g.
+     * `аpple.com` blending Cyrillic and Latin). Defaults to `false` —
+     * mixed-script hostnames are rejected as a homoglyph-attack guard.
+     * Single-script IDN hosts (e.g. `münchen.de`, `日本.jp`) are always
+     * allowed regardless of this flag.
+     */
+    readonly allowMixedScriptHostnames?: boolean;
+    /**
+     * Optional thumbnail derivation passed to {@link createStudioAssetSource}.
+     * Returning a string sets `StudioAsset.thumbnailUrl`; returning
+     * `undefined` suppresses the thumbnail (overriding the default-for-images
+     * behavior).
+     */
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+}
+/**
+ * Listener invoked after every registry mutation
+ * (`register` / `delete` / `rename` / `replace` / `setTags`). The
+ * `studio-asset-source` adapter wires its own listener set onto the
+ * registry so the sidebar re-runs `list()` whenever an asset changes.
+ */
+export type AssetRegistryListener = () => void;
+/**
+ * Search and filter options accepted by {@link AssetRegistry.search}.
+ *
+ * `query` matches case-insensitively against `id`, `name`, `tags`, and
+ * the MIME type (prefix match — e.g. `"image"` matches `"image/png"`).
+ * Filters compose with AND semantics: an entry must satisfy every
+ * supplied filter to land in the page.
+ */
+export interface AssetSearchOptions {
+    readonly query?: string;
+    readonly kinds?: readonly AssetKind[];
+    readonly tags?: readonly string[];
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+/**
+ * Pagination envelope returned by {@link AssetRegistry.search}.
+ *
+ * - `items` — the slice for the requested page.
+ * - `total` — total number of matches across all pages (post-filter).
+ * - `nextCursor` — opaque cursor for the next page, or `undefined` when
+ *   the result set is exhausted.
+ */
+export interface AssetSearchPage {
+    readonly items: readonly UploadResult[];
+    readonly total: number;
+    readonly nextCursor: string | undefined;
+}
+export interface AssetRegistry {
+    readonly register: (asset: UploadResult) => UploadResult;
+    readonly get: (id: string) => UploadResult | undefined;
+    readonly list: () => readonly UploadResult[];
+    /** Remove an asset. Returns `true` if an entry was removed. */
+    readonly delete: (id: string) => boolean;
+    /**
+     * Rename an asset in-place. Returns the updated entry, or `undefined`
+     * if no asset with that id exists.
+     */
+    readonly rename: (id: string, name: string) => UploadResult | undefined;
+    /**
+     * Replace an asset in-place. Preserves the entry's `id` even if the
+     * incoming `next` carries a different one. Returns the updated entry,
+     * or `undefined` if no asset with that id exists.
+     */
+    readonly replace: (id: string, next: UploadResult) => UploadResult | undefined;
+    /**
+     * Replace the tag set on an asset in-place. Empty arrays drop the
+     * `tags` field entirely. Tags are deduped, trimmed, lowercased, and
+     * frozen before storage. Returns the updated entry, or `undefined`
+     * if no asset with that id exists.
+     */
+    readonly setTags: (id: string, tags: readonly string[]) => UploadResult | undefined;
+    /**
+     * Search and paginate the registry. See {@link AssetSearchOptions}
+     * for filter semantics.
+     */
+    readonly search: (options?: AssetSearchOptions) => AssetSearchPage;
+    /**
+     * Subscribe to mutation notifications. The returned function
+     * unsubscribes the listener.
+     */
+    readonly subscribe: (listener: AssetRegistryListener) => () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/ui/AssetBrowser.cjs

@@ -0,0 +1,271 @@
+"use strict";
+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__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    AssetBrowser: ()=>AssetBrowser
+});
+const card_namespaceObject = require("@anvilkit/ui/card");
+const input_namespaceObject = require("@anvilkit/ui/input");
+const external_react_namespaceObject = require("react");
+const external_infer_kind_cjs_namespaceObject = require("../infer-kind.cjs");
+const KIND_FILTERS = [
+    "image",
+    "video",
+    "audio",
+    "font",
+    "document"
+];
+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 }) {
+    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 filteredAssets = external_react_namespaceObject.useMemo(()=>{
+        if (!searchEnabled) return assets;
+        const lower = query.trim().toLowerCase();
+        return assets.filter((asset)=>{
+            if (activeKinds.length > 0) {
+                if (!activeKinds.includes((0, external_infer_kind_cjs_namespaceObject.inferAssetKind)(asset))) return false;
+            }
+            if ("" === lower) return true;
+            if (asset.id.toLowerCase().includes(lower)) return true;
+            if (asset.name?.toLowerCase().includes(lower)) return true;
+            if (asset.meta?.mimeType?.toLowerCase().includes(lower)) return true;
+            if (asset.tags?.some((tag)=>tag.toLowerCase().includes(lower))) return true;
+            return false;
+        });
+    }, [
+        assets,
+        activeKinds,
+        query,
+        searchEnabled
+    ]);
+    const visibleSlice = external_react_namespaceObject.useMemo(()=>searchEnabled ? filteredAssets.slice(0, pageLimit) : filteredAssets, [
+        filteredAssets,
+        pageLimit,
+        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);
+        setActiveIndex((currentIndex)=>currentIndex >= 0 && currentIndex < total ? currentIndex : 0);
+    }, [
+        total
+    ]);
+    function moveFocus(nextIndex) {
+        if (0 === total) return;
+        const clampedIndex = Math.max(0, Math.min(nextIndex, total - 1));
+        setActiveIndex(clampedIndex);
+        if (isVirtualized && scrollContainerRef.current) {
+            const targetTop = clampedIndex * itemHeight;
+            const targetBottom = targetTop + itemHeight;
+            const viewTop = scrollContainerRef.current.scrollTop;
+            const viewBottom = viewTop + maxHeight;
+            if (targetTop < viewTop) scrollContainerRef.current.scrollTop = targetTop;
+            else if (targetBottom > viewBottom) scrollContainerRef.current.scrollTop = targetBottom - maxHeight;
+            queueMicrotask(()=>{
+                buttonRefs.current[clampedIndex]?.focus();
+            });
+            return;
+        }
+        buttonRefs.current[clampedIndex]?.focus();
+    }
+    function toggleKind(kind) {
+        setActiveKinds((current)=>current.includes(kind) ? current.filter((entry)=>entry !== kind) : [
+                ...current,
+                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", {
+            "aria-label": `Insert asset ${asset.id}`,
+            onClick: ()=>{
+                onInsert(asset);
+            },
+            onFocus: ()=>{
+                setActiveIndex(index);
+            },
+            onKeyDown: (event)=>{
+                if ("ArrowDown" === event.key) {
+                    event.preventDefault();
+                    moveFocus(index + 1);
+                    return;
+                }
+                if ("ArrowUp" === event.key) {
+                    event.preventDefault();
+                    moveFocus(index - 1);
+                    return;
+                }
+                if ("Home" === event.key) {
+                    event.preventDefault();
+                    moveFocus(0);
+                    return;
+                }
+                if ("End" === event.key) {
+                    event.preventDefault();
+                    moveFocus(total - 1);
+                    return;
+                }
+                if ("Enter" === event.key || " " === event.key) {
+                    event.preventDefault();
+                    onInsert(asset);
+                }
+            },
+            ref: (node)=>{
+                buttonRefs.current[index] = node;
+            },
+            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", {
+            "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", {
+            "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", {
+            "aria-label": `Delete asset ${asset.id}`,
+            "data-asset-action": "delete",
+            onClick: ()=>{
+                onDelete(asset);
+            },
+            type: "button"
+        }, "Delete") : null);
+    }
+    const filterRow = searchEnabled ? /*#__PURE__*/ external_react_namespaceObject.createElement("div", {
+        "data-asset-manager-filters": true
+    }, /*#__PURE__*/ external_react_namespaceObject.createElement(input_namespaceObject.Input, {
+        "aria-label": "Search assets",
+        onChange: (event)=>{
+            setQuery(event.target.value);
+            setPageLimit(pageSize);
+        },
+        placeholder: "Search by name, tag, or MIME",
+        value: query
+    }), /*#__PURE__*/ external_react_namespaceObject.createElement("div", {
+        "aria-label": "Asset kind filters",
+        role: "group"
+    }, KIND_FILTERS.map((kind)=>{
+        const active = activeKinds.includes(kind);
+        return /*#__PURE__*/ external_react_namespaceObject.createElement("button", {
+            "aria-label": `Filter ${kind} assets`,
+            "aria-pressed": active,
+            "data-asset-kind-filter": kind,
+            key: kind,
+            onClick: ()=>{
+                toggleKind(kind);
+                setPageLimit(pageSize);
+            },
+            type: "button"
+        }, kind);
+    }))) : null;
+    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", {
+            "aria-label": "Assets",
+            role: "list"
+        }, /*#__PURE__*/ external_react_namespaceObject.createElement("li", {
+            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)=>{
+            setScrollTop(event.currentTarget.scrollTop);
+        },
+        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", {
+        "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", {
+        "data-asset-action": "load-more",
+        onClick: ()=>{
+            setPageLimit((current)=>current + pageSize);
+        },
+        type: "button"
+    }, "Load more") : null));
+}
+exports.AssetBrowser = __webpack_exports__.AssetBrowser;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "AssetBrowser"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/ui/AssetBrowser.d.cts

@@ -0,0 +1,45 @@
+import type { UploadResult } from "../types.js";
+export interface AssetBrowserProps {
+    readonly assets: readonly UploadResult[];
+    readonly onInsert: (asset: UploadResult) => void;
+    /**
+     * Optional delete affordance. When provided each row renders a
+     * "Delete" action that hands the asset back to the host — typically
+     * to open a `DeleteAssetDialog`.
+     */
+    readonly onDelete?: (asset: UploadResult) => void;
+    /**
+     * Optional replace affordance. When provided each row renders a
+     * "Replace" action — typically to open a `ReplaceAssetDialog`.
+     */
+    readonly onReplace?: (asset: UploadResult) => void;
+    /**
+     * Optional metadata-edit affordance. When provided each row renders
+     * an "Edit" action — typically to open a `MetadataPanel` dialog so
+     * the user can rename + retag the asset.
+     */
+    readonly onEdit?: (asset: UploadResult) => void;
+    /**
+     * When `true`, renders the search input + kind chip row above the
+     * list. Off by default so existing AssetBrowser embeds (which
+     * pre-filter at the host layer) keep their previous chrome.
+     */
+    readonly searchEnabled?: boolean;
+    /**
+     * Page size used by the "Load more" affordance once the visible
+     * slice exceeds this number. Defaults to 100.
+     */
+    readonly pageSize?: number;
+    /**
+     * Threshold above which the list windows visible items. Below the
+     * threshold the entire list renders inline so small libraries skip
+     * scroll math entirely.
+     */
+    readonly virtualizeThreshold?: number;
+    /** Pixel height of a single row when virtualizing. */
+    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;
+//# sourceMappingURL=AssetBrowser.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssetBrowser.d.cts","sourceRoot":"","sources":["../../src/ui/AssetBrowser.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3D,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,sDAAsD;IACtD,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,2CAmVnB"}

package/dist/ui/AssetBrowser.d.ts

@@ -0,0 +1,45 @@
+import type { UploadResult } from "../types.js";
+export interface AssetBrowserProps {
+    readonly assets: readonly UploadResult[];
+    readonly onInsert: (asset: UploadResult) => void;
+    /**
+     * Optional delete affordance. When provided each row renders a
+     * "Delete" action that hands the asset back to the host — typically
+     * to open a `DeleteAssetDialog`.
+     */
+    readonly onDelete?: (asset: UploadResult) => void;
+    /**
+     * Optional replace affordance. When provided each row renders a
+     * "Replace" action — typically to open a `ReplaceAssetDialog`.
+     */
+    readonly onReplace?: (asset: UploadResult) => void;
+    /**
+     * Optional metadata-edit affordance. When provided each row renders
+     * an "Edit" action — typically to open a `MetadataPanel` dialog so
+     * the user can rename + retag the asset.
+     */
+    readonly onEdit?: (asset: UploadResult) => void;
+    /**
+     * When `true`, renders the search input + kind chip row above the
+     * list. Off by default so existing AssetBrowser embeds (which
+     * pre-filter at the host layer) keep their previous chrome.
+     */
+    readonly searchEnabled?: boolean;
+    /**
+     * Page size used by the "Load more" affordance once the visible
+     * slice exceeds this number. Defaults to 100.
+     */
+    readonly pageSize?: number;
+    /**
+     * Threshold above which the list windows visible items. Below the
+     * threshold the entire list renders inline so small libraries skip
+     * scroll math entirely.
+     */
+    readonly virtualizeThreshold?: number;
+    /** Pixel height of a single row when virtualizing. */
+    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;
+//# sourceMappingURL=AssetBrowser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AssetBrowser.d.ts","sourceRoot":"","sources":["../../src/ui/AssetBrowser.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAa,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3D,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,sDAAsD;IACtD,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,2CAmVnB"}