@anvilkit/plugin-asset-manager 0.1.1

package/dist/studio-asset-source.cjs

@@ -0,0 +1,211 @@
+"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__, {
+    MAX_CONCURRENT_UPLOADS: ()=>MAX_CONCURRENT_UPLOADS,
+    inferStudioAssetKind: ()=>inferStudioAssetKind,
+    createStudioAssetSource: ()=>createStudioAssetSource
+});
+const external_asset_reference_cjs_namespaceObject = require("./asset-reference.cjs");
+const external_infer_kind_cjs_namespaceObject = require("./infer-kind.cjs");
+const MAX_CONCURRENT_UPLOADS = 3;
+function createStudioAssetSource(options) {
+    const { registry, upload, getThumbnail } = options;
+    const maxConcurrent = Math.max(1, options.maxConcurrentUploads ?? MAX_CONCURRENT_UPLOADS);
+    const project = (entry)=>toStudioAsset(entry, getThumbnail);
+    const uploadListeners = new Set();
+    const fanOut = (event)=>{
+        for (const listener of uploadListeners)listener(event);
+    };
+    return {
+        list () {
+            return registry.list().map(project);
+        },
+        listPaginated (query) {
+            const page = registry.search({
+                ...void 0 !== query.query ? {
+                    query: query.query
+                } : {},
+                ...query.kinds ? {
+                    kinds: query.kinds
+                } : {},
+                ...query.tags ? {
+                    tags: query.tags
+                } : {},
+                ...void 0 !== query.cursor ? {
+                    cursor: query.cursor
+                } : {},
+                ...void 0 !== query.limit ? {
+                    limit: query.limit
+                } : {}
+            });
+            const projected = {
+                items: Object.freeze(page.items.map(project)),
+                total: page.total,
+                nextCursor: page.nextCursor
+            };
+            return Promise.resolve(projected);
+        },
+        async upload (files, listener) {
+            const fileList = Array.from(files);
+            if (0 === fileList.length) return [];
+            const totalBytes = fileList.reduce((acc, file)=>acc + file.size, 0);
+            let bytesUploaded = 0;
+            const results = new Array(fileList.length).fill(null);
+            let nextIndex = 0;
+            let abortError;
+            const emit = (event)=>{
+                listener?.(event);
+                fanOut(event);
+            };
+            const runWorker = async ()=>{
+                while(true){
+                    if (void 0 !== abortError) return;
+                    const index = nextIndex++;
+                    if (index >= fileList.length) return;
+                    const file = fileList[index];
+                    if (void 0 === file) return;
+                    try {
+                        const result = await upload(file);
+                        bytesUploaded += file.size;
+                        const asset = project(result);
+                        results[index] = asset;
+                        emit({
+                            type: "progress",
+                            bytesUploaded,
+                            bytesTotal: totalBytes
+                        });
+                        emit({
+                            type: "done",
+                            asset
+                        });
+                    } catch (error) {
+                        if (isAbortError(error)) {
+                            abortError = error;
+                            return;
+                        }
+                        const message = error instanceof Error ? error.message : String(error);
+                        emit({
+                            type: "error",
+                            message
+                        });
+                    }
+                }
+            };
+            const workerCount = Math.min(maxConcurrent, fileList.length);
+            const workers = [];
+            for(let i = 0; i < workerCount; i += 1)workers.push(runWorker());
+            await Promise.all(workers);
+            if (void 0 !== abortError) throw abortError;
+            return results.filter((value)=>null !== value);
+        },
+        delete (assetId) {
+            registry.delete(assetId);
+            return Promise.resolve();
+        },
+        rename (assetId, nextName) {
+            registry.rename(assetId, nextName);
+            return Promise.resolve();
+        },
+        setTags (assetId, tags) {
+            registry.setTags(assetId, tags);
+            return Promise.resolve();
+        },
+        async replace (assetId, file) {
+            const result = await upload(file);
+            const replaced = registry.replace(assetId, result);
+            if (void 0 === replaced) return project(result);
+            return project(replaced);
+        },
+        getUrl (assetId) {
+            return (0, external_asset_reference_cjs_namespaceObject.createAssetReference)(assetId);
+        },
+        subscribe (listener) {
+            return registry.subscribe(listener);
+        },
+        subscribeUploads (listener) {
+            uploadListeners.add(listener);
+            return ()=>{
+                uploadListeners.delete(listener);
+            };
+        }
+    };
+}
+function toStudioAsset(entry, getThumbnail) {
+    const kind = (0, external_infer_kind_cjs_namespaceObject.inferAssetKind)(entry);
+    const url = (0, external_asset_reference_cjs_namespaceObject.createAssetReference)(entry.id);
+    const name = entry.name ?? deriveFallbackName(entry);
+    const thumbnailUrl = deriveThumbnailUrl(entry, kind, getThumbnail);
+    const studioAsset = {
+        id: entry.id,
+        kind,
+        name,
+        url,
+        ...void 0 !== thumbnailUrl ? {
+            thumbnailUrl
+        } : {},
+        ...entry.meta?.mimeType !== void 0 ? {
+            mimeType: entry.meta.mimeType
+        } : {},
+        ...entry.meta?.size !== void 0 ? {
+            size: entry.meta.size
+        } : {},
+        ...entry.tags && entry.tags.length > 0 ? {
+            tags: Object.freeze([
+                ...entry.tags
+            ])
+        } : {}
+    };
+    return studioAsset;
+}
+function inferStudioAssetKind(entry) {
+    return (0, external_infer_kind_cjs_namespaceObject.inferAssetKind)(entry);
+}
+function deriveThumbnailUrl(entry, kind, getThumbnail) {
+    if (void 0 !== getThumbnail) return getThumbnail(entry);
+    return "image" === kind ? entry.url : void 0;
+}
+function deriveFallbackName(entry) {
+    const tail = entry.url.split(/[/?#]/).filter(Boolean).pop();
+    if (void 0 !== tail && "" !== tail && !tail.startsWith("data:")) return tail;
+    const idTail = entry.id.length > 12 ? `${entry.id.slice(0, 8)}…` : entry.id;
+    return `Asset ${idTail}`;
+}
+function isAbortError(error) {
+    if (null === error || "object" != typeof error) return false;
+    const name = error.name;
+    return "AbortError" === name;
+}
+exports.MAX_CONCURRENT_UPLOADS = __webpack_exports__.MAX_CONCURRENT_UPLOADS;
+exports.createStudioAssetSource = __webpack_exports__.createStudioAssetSource;
+exports.inferStudioAssetKind = __webpack_exports__.inferStudioAssetKind;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "MAX_CONCURRENT_UPLOADS",
+    "createStudioAssetSource",
+    "inferStudioAssetKind"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/studio-asset-source.d.cts

@@ -0,0 +1,52 @@
+/**
+ * @file `StudioAssetSource` adapter — bridges the asset-manager
+ * registry into the sidebar's `image` module.
+ *
+ * The sidebar reads through `ctx.registerAssetSource(source)`. This
+ * file shapes the registry's `UploadResult` rows into the `StudioAsset`
+ * shape the sidebar consumes, threads the upload pipeline through
+ * `uploadAsset()`, and notifies subscribers on every mutation.
+ *
+ * The adapter does not own state — it is a thin projection over the
+ * shared `AssetRegistry`. Mutation methods route back through the
+ * registry so the IR resolver and the sidebar see the same data.
+ */
+import type { StudioAssetKind, StudioAssetSource } from "@anvilkit/core/types";
+import type { AssetRegistry, UploadResult } from "./types.js";
+/**
+ * Default concurrency cap for batched uploads. Editors typically drag
+ * 1–10 files at a time; three concurrent uploads strikes a balance
+ * between throughput and politeness to host endpoints.
+ */
+export declare const MAX_CONCURRENT_UPLOADS = 3;
+export interface CreateStudioAssetSourceOptions {
+    readonly registry: AssetRegistry;
+    /**
+     * Performs the upload. Provided by the plugin so the adapter does
+     * not need to depend on `StudioPluginContext` directly.
+     */
+    readonly upload: (file: File) => Promise<UploadResult>;
+    /**
+     * Optional thumbnail derivation. Returning a string sets
+     * `StudioAsset.thumbnailUrl`; returning `undefined` suppresses the
+     * thumbnail (overriding the default-for-images behavior).
+     *
+     * When omitted, image-kind assets get the original URL as their
+     * thumbnail and other kinds get no thumbnail.
+     */
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+    /**
+     * Maximum number of uploads in flight. Defaults to
+     * `MAX_CONCURRENT_UPLOADS` (3). Set to 1 to restore the previous
+     * sequential behavior.
+     */
+    readonly maxConcurrentUploads?: number;
+}
+export declare function createStudioAssetSource(options: CreateStudioAssetSourceOptions): StudioAssetSource;
+/**
+ * Public alias for {@link inferAssetKind}. Preserved as the documented
+ * Studio-side projection so existing imports keep working; library
+ * search now uses the same logic via `infer-kind.ts`.
+ */
+export declare function inferStudioAssetKind(entry: UploadResult): StudioAssetKind;
+//# sourceMappingURL=studio-asset-source.d.cts.map

package/dist/studio-asset-source.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-asset-source.d.cts","sourceRoot":"","sources":["../src/studio-asset-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAEX,eAAe,EAGf,iBAAiB,EAGjB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,8BAA8B,GACrC,iBAAiB,CAqJnB;AA4BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAEzE"}

package/dist/studio-asset-source.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @file `StudioAssetSource` adapter — bridges the asset-manager
+ * registry into the sidebar's `image` module.
+ *
+ * The sidebar reads through `ctx.registerAssetSource(source)`. This
+ * file shapes the registry's `UploadResult` rows into the `StudioAsset`
+ * shape the sidebar consumes, threads the upload pipeline through
+ * `uploadAsset()`, and notifies subscribers on every mutation.
+ *
+ * The adapter does not own state — it is a thin projection over the
+ * shared `AssetRegistry`. Mutation methods route back through the
+ * registry so the IR resolver and the sidebar see the same data.
+ */
+import type { StudioAssetKind, StudioAssetSource } from "@anvilkit/core/types";
+import type { AssetRegistry, UploadResult } from "./types.js";
+/**
+ * Default concurrency cap for batched uploads. Editors typically drag
+ * 1–10 files at a time; three concurrent uploads strikes a balance
+ * between throughput and politeness to host endpoints.
+ */
+export declare const MAX_CONCURRENT_UPLOADS = 3;
+export interface CreateStudioAssetSourceOptions {
+    readonly registry: AssetRegistry;
+    /**
+     * Performs the upload. Provided by the plugin so the adapter does
+     * not need to depend on `StudioPluginContext` directly.
+     */
+    readonly upload: (file: File) => Promise<UploadResult>;
+    /**
+     * Optional thumbnail derivation. Returning a string sets
+     * `StudioAsset.thumbnailUrl`; returning `undefined` suppresses the
+     * thumbnail (overriding the default-for-images behavior).
+     *
+     * When omitted, image-kind assets get the original URL as their
+     * thumbnail and other kinds get no thumbnail.
+     */
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+    /**
+     * Maximum number of uploads in flight. Defaults to
+     * `MAX_CONCURRENT_UPLOADS` (3). Set to 1 to restore the previous
+     * sequential behavior.
+     */
+    readonly maxConcurrentUploads?: number;
+}
+export declare function createStudioAssetSource(options: CreateStudioAssetSourceOptions): StudioAssetSource;
+/**
+ * Public alias for {@link inferAssetKind}. Preserved as the documented
+ * Studio-side projection so existing imports keep working; library
+ * search now uses the same logic via `infer-kind.ts`.
+ */
+export declare function inferStudioAssetKind(entry: UploadResult): StudioAssetKind;
+//# sourceMappingURL=studio-asset-source.d.ts.map

package/dist/studio-asset-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-asset-source.d.ts","sourceRoot":"","sources":["../src/studio-asset-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAEX,eAAe,EAGf,iBAAiB,EAGjB,MAAM,sBAAsB,CAAC;AAI9B,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACvD;;;;;;;OAOG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,8BAA8B,GACrC,iBAAiB,CAqJnB;AA4BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAEzE"}

package/dist/studio-asset-source.js

@@ -0,0 +1,171 @@
+import { createAssetReference } from "./asset-reference.js";
+import { inferAssetKind } from "./infer-kind.js";
+const MAX_CONCURRENT_UPLOADS = 3;
+function createStudioAssetSource(options) {
+    const { registry, upload, getThumbnail } = options;
+    const maxConcurrent = Math.max(1, options.maxConcurrentUploads ?? MAX_CONCURRENT_UPLOADS);
+    const project = (entry)=>toStudioAsset(entry, getThumbnail);
+    const uploadListeners = new Set();
+    const fanOut = (event)=>{
+        for (const listener of uploadListeners)listener(event);
+    };
+    return {
+        list () {
+            return registry.list().map(project);
+        },
+        listPaginated (query) {
+            const page = registry.search({
+                ...void 0 !== query.query ? {
+                    query: query.query
+                } : {},
+                ...query.kinds ? {
+                    kinds: query.kinds
+                } : {},
+                ...query.tags ? {
+                    tags: query.tags
+                } : {},
+                ...void 0 !== query.cursor ? {
+                    cursor: query.cursor
+                } : {},
+                ...void 0 !== query.limit ? {
+                    limit: query.limit
+                } : {}
+            });
+            const projected = {
+                items: Object.freeze(page.items.map(project)),
+                total: page.total,
+                nextCursor: page.nextCursor
+            };
+            return Promise.resolve(projected);
+        },
+        async upload (files, listener) {
+            const fileList = Array.from(files);
+            if (0 === fileList.length) return [];
+            const totalBytes = fileList.reduce((acc, file)=>acc + file.size, 0);
+            let bytesUploaded = 0;
+            const results = new Array(fileList.length).fill(null);
+            let nextIndex = 0;
+            let abortError;
+            const emit = (event)=>{
+                listener?.(event);
+                fanOut(event);
+            };
+            const runWorker = async ()=>{
+                while(true){
+                    if (void 0 !== abortError) return;
+                    const index = nextIndex++;
+                    if (index >= fileList.length) return;
+                    const file = fileList[index];
+                    if (void 0 === file) return;
+                    try {
+                        const result = await upload(file);
+                        bytesUploaded += file.size;
+                        const asset = project(result);
+                        results[index] = asset;
+                        emit({
+                            type: "progress",
+                            bytesUploaded,
+                            bytesTotal: totalBytes
+                        });
+                        emit({
+                            type: "done",
+                            asset
+                        });
+                    } catch (error) {
+                        if (isAbortError(error)) {
+                            abortError = error;
+                            return;
+                        }
+                        const message = error instanceof Error ? error.message : String(error);
+                        emit({
+                            type: "error",
+                            message
+                        });
+                    }
+                }
+            };
+            const workerCount = Math.min(maxConcurrent, fileList.length);
+            const workers = [];
+            for(let i = 0; i < workerCount; i += 1)workers.push(runWorker());
+            await Promise.all(workers);
+            if (void 0 !== abortError) throw abortError;
+            return results.filter((value)=>null !== value);
+        },
+        delete (assetId) {
+            registry.delete(assetId);
+            return Promise.resolve();
+        },
+        rename (assetId, nextName) {
+            registry.rename(assetId, nextName);
+            return Promise.resolve();
+        },
+        setTags (assetId, tags) {
+            registry.setTags(assetId, tags);
+            return Promise.resolve();
+        },
+        async replace (assetId, file) {
+            const result = await upload(file);
+            const replaced = registry.replace(assetId, result);
+            if (void 0 === replaced) return project(result);
+            return project(replaced);
+        },
+        getUrl (assetId) {
+            return createAssetReference(assetId);
+        },
+        subscribe (listener) {
+            return registry.subscribe(listener);
+        },
+        subscribeUploads (listener) {
+            uploadListeners.add(listener);
+            return ()=>{
+                uploadListeners.delete(listener);
+            };
+        }
+    };
+}
+function toStudioAsset(entry, getThumbnail) {
+    const kind = inferAssetKind(entry);
+    const url = createAssetReference(entry.id);
+    const name = entry.name ?? deriveFallbackName(entry);
+    const thumbnailUrl = deriveThumbnailUrl(entry, kind, getThumbnail);
+    const studioAsset = {
+        id: entry.id,
+        kind,
+        name,
+        url,
+        ...void 0 !== thumbnailUrl ? {
+            thumbnailUrl
+        } : {},
+        ...entry.meta?.mimeType !== void 0 ? {
+            mimeType: entry.meta.mimeType
+        } : {},
+        ...entry.meta?.size !== void 0 ? {
+            size: entry.meta.size
+        } : {},
+        ...entry.tags && entry.tags.length > 0 ? {
+            tags: Object.freeze([
+                ...entry.tags
+            ])
+        } : {}
+    };
+    return studioAsset;
+}
+function inferStudioAssetKind(entry) {
+    return inferAssetKind(entry);
+}
+function deriveThumbnailUrl(entry, kind, getThumbnail) {
+    if (void 0 !== getThumbnail) return getThumbnail(entry);
+    return "image" === kind ? entry.url : void 0;
+}
+function deriveFallbackName(entry) {
+    const tail = entry.url.split(/[/?#]/).filter(Boolean).pop();
+    if (void 0 !== tail && "" !== tail && !tail.startsWith("data:")) return tail;
+    const idTail = entry.id.length > 12 ? `${entry.id.slice(0, 8)}…` : entry.id;
+    return `Asset ${idTail}`;
+}
+function isAbortError(error) {
+    if (null === error || "object" != typeof error) return false;
+    const name = error.name;
+    return "AbortError" === name;
+}
+export { MAX_CONCURRENT_UPLOADS, createStudioAssetSource, inferStudioAssetKind };

package/dist/testing/index.cjs

@@ -0,0 +1,66 @@
+"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__, {
+    createTestRegistry: ()=>createTestRegistry,
+    fakeUploader: ()=>fakeUploader
+});
+const external_registry_cjs_namespaceObject = require("../registry.cjs");
+function createTestRegistry(options = {}) {
+    const registry = (0, external_registry_cjs_namespaceObject.createAssetRegistry)();
+    for (const entry of options.initial ?? [])registry.register(entry);
+    return registry;
+}
+function fakeUploader(options = {}) {
+    const responses = options.responses ?? {};
+    return async (file)=>{
+        const canned = responses[file.name];
+        if (void 0 !== canned) return canned;
+        const meta = {
+            size: file.size,
+            ...file.type ? {
+                mimeType: file.type
+            } : {}
+        };
+        return {
+            id: `asset-${slug(file.name)}`,
+            url: `https://test.local/${encodeURIComponent(file.name)}`,
+            name: file.name,
+            meta
+        };
+    };
+}
+function slug(value) {
+    return value.replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+exports.createTestRegistry = __webpack_exports__.createTestRegistry;
+exports.fakeUploader = __webpack_exports__.fakeUploader;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createTestRegistry",
+    "fakeUploader"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/testing/index.d.cts

@@ -0,0 +1,24 @@
+/**
+ * @file Test fixtures for downstream plugin authors building on
+ * `@anvilkit/plugin-asset-manager`.
+ *
+ * For Studio plugin context fakes, use
+ * `@anvilkit/core/testing.createFakeStudioContext` — these helpers focus
+ * on the registry + uploader contracts owned by this package.
+ */
+import type { AssetRegistry, UploadAdapter, UploadResult } from "../types.js";
+export interface CreateTestRegistryOptions {
+    readonly initial?: readonly UploadResult[];
+}
+export declare function createTestRegistry(options?: CreateTestRegistryOptions): AssetRegistry;
+export interface FakeUploaderOptions {
+    /**
+     * Optional map keyed by `File.name`. When a file is uploaded whose
+     * name appears in the map, the corresponding `UploadResult` is
+     * returned verbatim. Otherwise a deterministic synthetic result is
+     * returned (`asset-{name}`, `https://test.local/{name}`).
+     */
+    readonly responses?: Record<string, UploadResult>;
+}
+export declare function fakeUploader(options?: FakeUploaderOptions): UploadAdapter;
+//# sourceMappingURL=index.d.cts.map

package/dist/testing/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CACjC,OAAO,GAAE,yBAA8B,GACrC,aAAa,CAMf;AAED,MAAM,WAAW,mBAAmB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAClD;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa,CAkB7E"}

package/dist/testing/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @file Test fixtures for downstream plugin authors building on
+ * `@anvilkit/plugin-asset-manager`.
+ *
+ * For Studio plugin context fakes, use
+ * `@anvilkit/core/testing.createFakeStudioContext` — these helpers focus
+ * on the registry + uploader contracts owned by this package.
+ */
+import type { AssetRegistry, UploadAdapter, UploadResult } from "../types.js";
+export interface CreateTestRegistryOptions {
+    readonly initial?: readonly UploadResult[];
+}
+export declare function createTestRegistry(options?: CreateTestRegistryOptions): AssetRegistry;
+export interface FakeUploaderOptions {
+    /**
+     * Optional map keyed by `File.name`. When a file is uploaded whose
+     * name appears in the map, the corresponding `UploadResult` is
+     * returned verbatim. Otherwise a deterministic synthetic result is
+     * returned (`asset-{name}`, `https://test.local/{name}`).
+     */
+    readonly responses?: Record<string, UploadResult>;
+}
+export declare function fakeUploader(options?: FakeUploaderOptions): UploadAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAEX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,yBAAyB;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C;AAED,wBAAgB,kBAAkB,CACjC,OAAO,GAAE,yBAA8B,GACrC,aAAa,CAMf;AAED,MAAM,WAAW,mBAAmB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAClD;AAED,wBAAgB,YAAY,CAAC,OAAO,GAAE,mBAAwB,GAAG,aAAa,CAkB7E"}

package/dist/testing/index.js

@@ -0,0 +1,29 @@
+import { createAssetRegistry } from "../registry.js";
+function createTestRegistry(options = {}) {
+    const registry = createAssetRegistry();
+    for (const entry of options.initial ?? [])registry.register(entry);
+    return registry;
+}
+function fakeUploader(options = {}) {
+    const responses = options.responses ?? {};
+    return async (file)=>{
+        const canned = responses[file.name];
+        if (void 0 !== canned) return canned;
+        const meta = {
+            size: file.size,
+            ...file.type ? {
+                mimeType: file.type
+            } : {}
+        };
+        return {
+            id: `asset-${slug(file.name)}`,
+            url: `https://test.local/${encodeURIComponent(file.name)}`,
+            name: file.name,
+            meta
+        };
+    };
+}
+function slug(value) {
+    return value.replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+export { createTestRegistry, fakeUploader };

package/dist/types.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __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__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});