@anvilkit/plugin-asset-manager 0.1.8 → 0.1.10

package/dist/utils/asset-reference.js

@@ -1,4 +1,84 @@
-function createAssetReference(id) {
-    return `asset://${id}`;
+const ASSET_REFERENCE_PREFIX = "asset://";
+function createAssetReference(id, transform) {
+    const base = `${ASSET_REFERENCE_PREFIX}${encodeId(id)}`;
+    if (void 0 === transform) return base;
+    const query = encodeTransform(transform);
+    return "" === query ? base : `${base}?${query}`;
 }
-export { createAssetReference };
+function parseAssetReference(url) {
+    if (!url.startsWith(ASSET_REFERENCE_PREFIX)) return null;
+    const rest = url.slice(ASSET_REFERENCE_PREFIX.length);
+    const queryIndex = rest.indexOf("?");
+    const id = decodeId((-1 === queryIndex ? rest : rest.slice(0, queryIndex)).trim());
+    if ("" === id) return null;
+    if (-1 === queryIndex) return {
+        id
+    };
+    const transform = decodeTransform(rest.slice(queryIndex + 1));
+    return void 0 === transform ? {
+        id
+    } : {
+        id,
+        transform
+    };
+}
+function encodeId(id) {
+    return id.replace(/%/g, "%25").replace(/\?/g, "%3F").replace(/#/g, "%23");
+}
+function decodeId(id) {
+    return id.replace(/%3F/gi, "?").replace(/%23/gi, "#").replace(/%25/g, "%");
+}
+const FITS = new Set([
+    "cover",
+    "contain",
+    "fill",
+    "inside",
+    "outside"
+]);
+const FORMATS = new Set([
+    "webp",
+    "avif",
+    "jpeg",
+    "png",
+    "auto"
+]);
+function encodeTransform(transform) {
+    const params = new URLSearchParams();
+    if (void 0 !== transform.width) params.set("w", String(transform.width));
+    if (void 0 !== transform.height) params.set("h", String(transform.height));
+    if (void 0 !== transform.fit) params.set("fit", transform.fit);
+    if (void 0 !== transform.format) params.set("fm", transform.format);
+    if (void 0 !== transform.quality) params.set("q", String(transform.quality));
+    if (void 0 !== transform.dpr) params.set("dpr", String(transform.dpr));
+    return params.toString();
+}
+function decodeTransform(query) {
+    const params = new URLSearchParams(query);
+    const out = {};
+    const width = toPositiveInteger(params.get("w"));
+    if (void 0 !== width) out.width = width;
+    const height = toPositiveInteger(params.get("h"));
+    if (void 0 !== height) out.height = height;
+    const fit = params.get("fit");
+    if (FITS.has(fit)) out.fit = fit;
+    const format = params.get("fm");
+    if (FORMATS.has(format)) out.format = format;
+    const quality = toPositiveInteger(params.get("q"));
+    if (void 0 !== quality && quality <= 100) out.quality = quality;
+    const dpr = toPositiveNumber(params.get("dpr"));
+    if (void 0 !== dpr) out.dpr = dpr;
+    return Object.keys(out).length > 0 ? out : void 0;
+}
+const DECIMAL_INTEGER_RE = /^[0-9]+$/;
+const DECIMAL_NUMBER_RE = /^[0-9]+(?:\.[0-9]+)?$/;
+function toPositiveInteger(value) {
+    if (null === value || !DECIMAL_INTEGER_RE.test(value)) return;
+    const n = Number(value);
+    return Number.isSafeInteger(n) && n > 0 ? n : void 0;
+}
+function toPositiveNumber(value) {
+    if (null === value || !DECIMAL_NUMBER_RE.test(value)) return;
+    const n = Number(value);
+    return Number.isFinite(n) && n > 0 ? n : void 0;
+}
+export { createAssetReference, parseAssetReference };

package/dist/utils/csp.cjs

@@ -55,6 +55,22 @@ function getRequiredCsp(options = {}) {
             mediaSrc.add(presignOrigin);
         }
     }
+    const multipartList = Array.isArray(options.s3Multipart) ? options.s3Multipart : options.s3Multipart ? [
+        options.s3Multipart
+    ] : [];
+    for (const entry of multipartList){
+        const endpointOrigin = parseOrigin(entry.endpoint);
+        if (void 0 !== endpointOrigin) connectSrc.add(endpointOrigin);
+        const bucketOrigin = void 0 !== entry.bucketHost ? parseOrigin(entry.bucketHost) : void 0;
+        if (void 0 !== bucketOrigin) connectSrc.add(bucketOrigin);
+        const publicOrigin = void 0 !== entry.publicHost ? parseOrigin(entry.publicHost) : void 0;
+        const serveOrigin = publicOrigin ?? bucketOrigin;
+        if (void 0 !== serveOrigin) {
+            connectSrc.add(serveOrigin);
+            imgSrc.add(serveOrigin);
+            mediaSrc.add(serveOrigin);
+        }
+    }
     return Object.freeze({
         connectSrc: Object.freeze([
             ...connectSrc

package/dist/utils/csp.d.cts

@@ -28,6 +28,25 @@ export interface S3CspOptions {
      */
     readonly publicHost?: string;
 }
+/** CSP inputs for an `s3MultipartAdapter` instance. */
+export interface S3MultipartCspOptions {
+    /** The broker `endpoint` configured on `s3MultipartAdapter`. */
+    readonly endpoint: string | URL;
+    /**
+     * Origin that part PUTs and the completed object live on (e.g.
+     * `https://my-bucket.s3.amazonaws.com`). Presigned part URLs target it
+     * directly, so it must be in `connect-src`. When omitted, only the broker
+     * endpoint origin is added and you must allow the bucket origin yourself.
+     */
+    readonly bucketHost?: string;
+    /**
+     * Separate public/CDN origin the completed object is served from, if it
+     * differs from `bucketHost`. Added to `connect-src` / `img-src` /
+     * `media-src`.
+     */
+    readonly publicHost?: string;
+}
+/** Inputs describing which asset backends need CSP allowances. */
 export interface RequiredCspOptions {
     /** True if `dataUrlUploader` is mounted. Defaults to false. */
     readonly dataUrl?: boolean;
@@ -35,11 +54,15 @@ export interface RequiredCspOptions {
     readonly inMemory?: boolean;
     /** Description of any `s3PresignedAdapter` instance(s). */
     readonly s3?: S3CspOptions | readonly S3CspOptions[];
+    /** Description of any `s3MultipartAdapter` instance(s). */
+    readonly s3Multipart?: S3MultipartCspOptions | readonly S3MultipartCspOptions[];
 }
+/** Computed CSP directive sources needed for configured asset backends. */
 export interface RequiredCsp {
     readonly connectSrc: readonly string[];
     readonly imgSrc: readonly string[];
     readonly mediaSrc: readonly string[];
 }
+/** Compute CSP origins required by the configured asset upload backends. */
 export declare function getRequiredCsp(options?: RequiredCspOptions): RequiredCsp;
 //# sourceMappingURL=csp.d.cts.map

package/dist/utils/csp.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"csp.d.cts","sourceRoot":"","sources":["../../src/utils/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,YAAY;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CA4C5E"}
+{"version":3,"file":"csp.d.cts","sourceRoot":"","sources":["../../src/utils/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,YAAY;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACrC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,CAAC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAClB,qBAAqB,GACrB,SAAS,qBAAqB,EAAE,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAyE5E"}

package/dist/utils/csp.d.ts

@@ -28,6 +28,25 @@ export interface S3CspOptions {
      */
     readonly publicHost?: string;
 }
+/** CSP inputs for an `s3MultipartAdapter` instance. */
+export interface S3MultipartCspOptions {
+    /** The broker `endpoint` configured on `s3MultipartAdapter`. */
+    readonly endpoint: string | URL;
+    /**
+     * Origin that part PUTs and the completed object live on (e.g.
+     * `https://my-bucket.s3.amazonaws.com`). Presigned part URLs target it
+     * directly, so it must be in `connect-src`. When omitted, only the broker
+     * endpoint origin is added and you must allow the bucket origin yourself.
+     */
+    readonly bucketHost?: string;
+    /**
+     * Separate public/CDN origin the completed object is served from, if it
+     * differs from `bucketHost`. Added to `connect-src` / `img-src` /
+     * `media-src`.
+     */
+    readonly publicHost?: string;
+}
+/** Inputs describing which asset backends need CSP allowances. */
 export interface RequiredCspOptions {
     /** True if `dataUrlUploader` is mounted. Defaults to false. */
     readonly dataUrl?: boolean;
@@ -35,11 +54,15 @@ export interface RequiredCspOptions {
     readonly inMemory?: boolean;
     /** Description of any `s3PresignedAdapter` instance(s). */
     readonly s3?: S3CspOptions | readonly S3CspOptions[];
+    /** Description of any `s3MultipartAdapter` instance(s). */
+    readonly s3Multipart?: S3MultipartCspOptions | readonly S3MultipartCspOptions[];
 }
+/** Computed CSP directive sources needed for configured asset backends. */
 export interface RequiredCsp {
     readonly connectSrc: readonly string[];
     readonly imgSrc: readonly string[];
     readonly mediaSrc: readonly string[];
 }
+/** Compute CSP origins required by the configured asset upload backends. */
 export declare function getRequiredCsp(options?: RequiredCspOptions): RequiredCsp;
 //# sourceMappingURL=csp.d.ts.map

package/dist/utils/csp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"csp.d.ts","sourceRoot":"","sources":["../../src/utils/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,YAAY;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CA4C5E"}
+{"version":3,"file":"csp.d.ts","sourceRoot":"","sources":["../../src/utils/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,YAAY;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,GAAG,CAAC;IACvC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACrC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IAClC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,CAAC,EAAE,YAAY,GAAG,SAAS,YAAY,EAAE,CAAC;IACrD,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,CAAC,EAClB,qBAAqB,GACrB,SAAS,qBAAqB,EAAE,CAAC;CACpC;AAED,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAyE5E"}

package/dist/utils/csp.js

@@ -26,6 +26,22 @@ function getRequiredCsp(options = {}) {
             mediaSrc.add(presignOrigin);
         }
     }
+    const multipartList = Array.isArray(options.s3Multipart) ? options.s3Multipart : options.s3Multipart ? [
+        options.s3Multipart
+    ] : [];
+    for (const entry of multipartList){
+        const endpointOrigin = parseOrigin(entry.endpoint);
+        if (void 0 !== endpointOrigin) connectSrc.add(endpointOrigin);
+        const bucketOrigin = void 0 !== entry.bucketHost ? parseOrigin(entry.bucketHost) : void 0;
+        if (void 0 !== bucketOrigin) connectSrc.add(bucketOrigin);
+        const publicOrigin = void 0 !== entry.publicHost ? parseOrigin(entry.publicHost) : void 0;
+        const serveOrigin = publicOrigin ?? bucketOrigin;
+        if (void 0 !== serveOrigin) {
+            connectSrc.add(serveOrigin);
+            imgSrc.add(serveOrigin);
+            mediaSrc.add(serveOrigin);
+        }
+    }
     return Object.freeze({
         connectSrc: Object.freeze([
             ...connectSrc

package/dist/utils/data-source.cjs

@@ -46,6 +46,9 @@ function makeAbortError() {
     error.name = "AbortError";
     return error;
 }
+function makeMoveDisabledError() {
+    return new external_errors_cjs_namespaceObject.AssetSourceError("MOVE_REJECTED", "Asset and folder moves are disabled by FolderOptions.allowMove.");
+}
 function createInMemoryDataSource(options) {
     const { registry, upload, maxDepth } = options;
     const folders = options.folderStore ?? (0, external_folders_cjs_namespaceObject.createFolderStore)();
@@ -84,10 +87,12 @@ function createInMemoryDataSource(options) {
             }
             return Promise.resolve(buildPage((0, external_registry_cjs_namespaceObject.paginateMatches)(matches, query), query));
         },
-        remove (id) {
+        async remove (id) {
+            const removed = registry.get(id);
+            if (void 0 === removed) throw new external_errors_cjs_namespaceObject.AssetSourceError("ASSET_MUTATION_REJECTED", `Cannot delete unknown asset "${id}".`);
             registry.delete(id);
             folders.removeAsset(id);
-            return Promise.resolve();
+            await options.onDelete?.(removed);
         },
         async replace (id, payload, signal) {
             const result = await upload(payload, signal ? {
@@ -103,6 +108,7 @@ function createInMemoryDataSource(options) {
             return Promise.resolve(updated);
         },
         move (id, folderId) {
+            if (false === options.allowMove) return Promise.reject(makeMoveDisabledError());
             folders.moveAsset(id, folderId);
             return Promise.resolve();
         },
@@ -112,12 +118,16 @@ function createInMemoryDataSource(options) {
         renameFolder (id, name) {
             return Promise.resolve(folders.renameFolder(id, name));
         },
-        removeFolder (id, opts) {
+        async removeFolder (id, opts) {
             const { removedAssetIds } = folders.removeFolder(id, opts);
-            for (const assetId of removedAssetIds)registry.delete(assetId);
-            return Promise.resolve();
+            for (const assetId of removedAssetIds){
+                const removed = registry.get(assetId);
+                registry.delete(assetId);
+                if (void 0 !== removed) await options.onDelete?.(removed);
+            }
         },
         moveFolder (id, parentId) {
+            if (false === options.allowMove) return Promise.reject(makeMoveDisabledError());
             return Promise.resolve(folders.moveFolder(id, parentId, maxDepth));
         },
         subscribe (listener) {
@@ -177,6 +187,10 @@ function resolveDataSource(input) {
         resolved.moveFolder = host.moveFolder.bind(host);
     }
     if ("function" == typeof host.subscribeStatus) resolved.subscribeStatus = host.subscribeStatus.bind(host);
+    if (false === input.allowMove) {
+        resolved.move = ()=>Promise.reject(makeMoveDisabledError());
+        resolved.moveFolder = ()=>Promise.reject(makeMoveDisabledError());
+    }
     return resolved;
 }
 exports.createInMemoryDataSource = __webpack_exports__.createInMemoryDataSource;

package/dist/utils/data-source.d.cts

@@ -8,7 +8,7 @@
 import type { AssetDataSource, AssetSourceStatus, ReplacePayload } from "../types/data-source.js";
 import type { AssetFilter, AssetListPage } from "../types/filter.js";
 import type { AssetFolder, FolderId } from "../types/folders.js";
-import type { AssetRegistry, UploadResult } from "../types/types.js";
+import type { AssetDeletedHook, AssetRegistry, UploadResult } from "../types/types.js";
 import { type FolderStore } from "./folders.js";
 /**
  * Binary ingest used by `replace` — the same `uploadAsset`-bound callback the
@@ -43,6 +43,10 @@ export interface CreateInMemoryDataSourceOptions {
     readonly folderStore?: FolderStore;
     /** Max nesting depth from `FolderOptions`. */
     readonly maxDepth?: number;
+    /** Allow moving assets/folders. `undefined` ⇒ treated as `true`. */
+    readonly allowMove?: boolean;
+    /** Fired with the removed record after a successful asset delete. */
+    readonly onDelete?: AssetDeletedHook;
 }
 export declare function createInMemoryDataSource(options: CreateInMemoryDataSourceOptions): ResolvedAssetDataSource;
 export interface ResolveDataSourceInput extends CreateInMemoryDataSourceOptions {

package/dist/utils/data-source.d.cts.map

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

package/dist/utils/data-source.d.ts

@@ -8,7 +8,7 @@
 import type { AssetDataSource, AssetSourceStatus, ReplacePayload } from "../types/data-source.js";
 import type { AssetFilter, AssetListPage } from "../types/filter.js";
 import type { AssetFolder, FolderId } from "../types/folders.js";
-import type { AssetRegistry, UploadResult } from "../types/types.js";
+import type { AssetDeletedHook, AssetRegistry, UploadResult } from "../types/types.js";
 import { type FolderStore } from "./folders.js";
 /**
  * Binary ingest used by `replace` — the same `uploadAsset`-bound callback the
@@ -43,6 +43,10 @@ export interface CreateInMemoryDataSourceOptions {
     readonly folderStore?: FolderStore;
     /** Max nesting depth from `FolderOptions`. */
     readonly maxDepth?: number;
+    /** Allow moving assets/folders. `undefined` ⇒ treated as `true`. */
+    readonly allowMove?: boolean;
+    /** Fired with the removed record after a successful asset delete. */
+    readonly onDelete?: AssetDeletedHook;
 }
 export declare function createInMemoryDataSource(options: CreateInMemoryDataSourceOptions): ResolvedAssetDataSource;
 export interface ResolveDataSourceInput extends CreateInMemoryDataSourceOptions {

package/dist/utils/data-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/utils/data-source.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACX,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,KAAK,EACX,aAAa,EAEb,YAAY,EACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGnE;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CACtB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,KACvC,OAAO,CAAC,YAAY,CAAC,CAAC;AAE3B,mFAAmF;AACnF,MAAM,WAAW,uBAAuB;IACvC,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACvE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,CACN,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,cAAc,EACvB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9E,IAAI,CACH,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,YAAY,CACX,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EACrC,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CACT,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,oEAAoE;IACpE,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC;IAC5C,eAAe,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC3E,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC9B;AAED,MAAM,WAAW,+BAA+B;IAC/C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B;AAuBD,wBAAgB,wBAAwB,CACvC,OAAO,EAAE,+BAA+B,GACtC,uBAAuB,CA8HzB;AAiBD,MAAM,WAAW,sBAChB,SAAQ,+BAA+B;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,CAAC,EAAE,eAAe,CAAC;IAC1C,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,sBAAsB,GAC3B,uBAAuB,CA0CzB"}
+{"version":3,"file":"data-source.d.ts","sourceRoot":"","sources":["../../src/utils/data-source.ts"],"names":[],"mappings":"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"}

package/dist/utils/data-source.js

@@ -13,6 +13,9 @@ function makeAbortError() {
     error.name = "AbortError";
     return error;
 }
+function makeMoveDisabledError() {
+    return new AssetSourceError("MOVE_REJECTED", "Asset and folder moves are disabled by FolderOptions.allowMove.");
+}
 function createInMemoryDataSource(options) {
     const { registry, upload, maxDepth } = options;
     const folders = options.folderStore ?? createFolderStore();
@@ -51,10 +54,12 @@ function createInMemoryDataSource(options) {
             }
             return Promise.resolve(buildPage(paginateMatches(matches, query), query));
         },
-        remove (id) {
+        async remove (id) {
+            const removed = registry.get(id);
+            if (void 0 === removed) throw new AssetSourceError("ASSET_MUTATION_REJECTED", `Cannot delete unknown asset "${id}".`);
             registry.delete(id);
             folders.removeAsset(id);
-            return Promise.resolve();
+            await options.onDelete?.(removed);
         },
         async replace (id, payload, signal) {
             const result = await upload(payload, signal ? {
@@ -70,6 +75,7 @@ function createInMemoryDataSource(options) {
             return Promise.resolve(updated);
         },
         move (id, folderId) {
+            if (false === options.allowMove) return Promise.reject(makeMoveDisabledError());
             folders.moveAsset(id, folderId);
             return Promise.resolve();
         },
@@ -79,12 +85,16 @@ function createInMemoryDataSource(options) {
         renameFolder (id, name) {
             return Promise.resolve(folders.renameFolder(id, name));
         },
-        removeFolder (id, opts) {
+        async removeFolder (id, opts) {
             const { removedAssetIds } = folders.removeFolder(id, opts);
-            for (const assetId of removedAssetIds)registry.delete(assetId);
-            return Promise.resolve();
+            for (const assetId of removedAssetIds){
+                const removed = registry.get(assetId);
+                registry.delete(assetId);
+                if (void 0 !== removed) await options.onDelete?.(removed);
+            }
         },
         moveFolder (id, parentId) {
+            if (false === options.allowMove) return Promise.reject(makeMoveDisabledError());
             return Promise.resolve(folders.moveFolder(id, parentId, maxDepth));
         },
         subscribe (listener) {
@@ -144,6 +154,10 @@ function resolveDataSource(input) {
         resolved.moveFolder = host.moveFolder.bind(host);
     }
     if ("function" == typeof host.subscribeStatus) resolved.subscribeStatus = host.subscribeStatus.bind(host);
+    if (false === input.allowMove) {
+        resolved.move = ()=>Promise.reject(makeMoveDisabledError());
+        resolved.moveFolder = ()=>Promise.reject(makeMoveDisabledError());
+    }
     return resolved;
 }
 export { createInMemoryDataSource, resolveDataSource };

package/dist/utils/errors.d.cts

@@ -1,5 +1,7 @@
+/** Error thrown when an upload adapter returns an invalid result. */
 export declare class AssetValidationError extends Error {
     readonly code: string;
+    /** Create a validation error with a stable machine-readable code. */
     constructor(code: string, message: string, options?: {
         readonly cause?: unknown;
     });
@@ -24,6 +26,7 @@ export declare class AssetSourceError extends Error {
     readonly retryable: boolean;
     readonly status?: number;
     readonly retryAfterMs?: number;
+    /** Create an asset-source error with optional retry and status metadata. */
     constructor(code: AssetSourceErrorCode, message: string, options?: {
         readonly cause?: unknown;
         readonly retryable?: boolean;
@@ -32,9 +35,11 @@ export declare class AssetSourceError extends Error {
     });
 }
 export type AssetResolutionErrorCode = "ASSET_NOT_FOUND" | "ASSET_URL_REJECTED" | "ASSET_VALIDATION_FAILED";
+/** Error thrown when an `asset://` reference cannot be resolved safely. */
 export declare class AssetResolutionError extends Error {
     readonly assetId: string;
     readonly code: AssetResolutionErrorCode;
+    /** Create a resolver error for a specific asset id and failure code. */
     constructor(assetId: string, code?: AssetResolutionErrorCode, message?: string, options?: {
         readonly cause?: unknown;
     });

package/dist/utils/errors.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.cts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC7B,yBAAyB,GACzB,qBAAqB,GACrB,yBAAyB,GACzB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAClB,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAEzB;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG9B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAC/B;CAaF;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}
+{"version":3,"file":"errors.d.cts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,qEAAqE;gBAEpE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC7B,yBAAyB,GACzB,qBAAqB,GACrB,yBAAyB,GACzB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAClB,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAEzB;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,4EAA4E;gBAE3E,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAC/B;CAaF;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,2EAA2E;AAC3E,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IAExC,wEAAwE;gBAEvE,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}

package/dist/utils/errors.d.ts

@@ -1,5 +1,7 @@
+/** Error thrown when an upload adapter returns an invalid result. */
 export declare class AssetValidationError extends Error {
     readonly code: string;
+    /** Create a validation error with a stable machine-readable code. */
     constructor(code: string, message: string, options?: {
         readonly cause?: unknown;
     });
@@ -24,6 +26,7 @@ export declare class AssetSourceError extends Error {
     readonly retryable: boolean;
     readonly status?: number;
     readonly retryAfterMs?: number;
+    /** Create an asset-source error with optional retry and status metadata. */
     constructor(code: AssetSourceErrorCode, message: string, options?: {
         readonly cause?: unknown;
         readonly retryable?: boolean;
@@ -32,9 +35,11 @@ export declare class AssetSourceError extends Error {
     });
 }
 export type AssetResolutionErrorCode = "ASSET_NOT_FOUND" | "ASSET_URL_REJECTED" | "ASSET_VALIDATION_FAILED";
+/** Error thrown when an `asset://` reference cannot be resolved safely. */
 export declare class AssetResolutionError extends Error {
     readonly assetId: string;
     readonly code: AssetResolutionErrorCode;
+    /** Create a resolver error for a specific asset id and failure code. */
     constructor(assetId: string, code?: AssetResolutionErrorCode, message?: string, options?: {
         readonly cause?: unknown;
     });

package/dist/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC7B,yBAAyB,GACzB,qBAAqB,GACrB,yBAAyB,GACzB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAClB,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAEzB;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAG9B,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAC/B;CAaF;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,qEAAqE;gBAEpE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAUvC;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC7B,yBAAyB,GACzB,qBAAqB,GACrB,yBAAyB,GACzB,kBAAkB,GAClB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,eAAe,GACf,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,GAClB,uBAAuB,GACvB,kBAAkB,GAClB,qBAAqB,CAAC;AAEzB;;;;;;;GAOG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B,4EAA4E;gBAE3E,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACT,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAC/B;CAaF;AAED,MAAM,MAAM,wBAAwB,GACjC,iBAAiB,GACjB,oBAAoB,GACpB,yBAAyB,CAAC;AAE7B,2EAA2E;AAC3E,qBAAa,oBAAqB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IAExC,wEAAwE;gBAEvE,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,wBAA4C,EAClD,OAAO,SAAyC,EAChD,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAWvC"}

package/dist/utils/query-param-transform.cjs

@@ -0,0 +1,101 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __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");
+    };
+})();
+(()=>{
+    __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__);
+function deriveVariantUrl(asset, transform, resolver) {
+    return resolver(asset, transform) ?? asset.url;
+}
+function createQueryParamTransformResolver(options = {}) {
+    const names = {
+        width: options.params?.width ?? "w",
+        height: options.params?.height ?? "h",
+        fit: options.params?.fit ?? "fit",
+        format: options.params?.format ?? "fm",
+        quality: options.params?.quality ?? "q",
+        dpr: options.params?.dpr ?? "dpr"
+    };
+    return (asset, transform)=>{
+        const params = [];
+        if (void 0 !== transform.width) params.push([
+            names.width,
+            String(transform.width)
+        ]);
+        if (void 0 !== transform.height) params.push([
+            names.height,
+            String(transform.height)
+        ]);
+        if (void 0 !== transform.fit) params.push([
+            names.fit,
+            options.fitMap?.[transform.fit] ?? transform.fit
+        ]);
+        if (void 0 !== transform.format) params.push([
+            names.format,
+            options.formatMap?.[transform.format] ?? transform.format
+        ]);
+        if (void 0 !== transform.quality) params.push([
+            names.quality,
+            String(transform.quality)
+        ]);
+        if (void 0 !== transform.dpr) params.push([
+            names.dpr,
+            String(transform.dpr)
+        ]);
+        if (0 === params.length) return;
+        return appendQueryParams(asset.url, params);
+    };
+}
+function appendQueryParams(rawUrl, params) {
+    try {
+        const url = new URL(rawUrl);
+        for (const [key, value] of params)url.searchParams.set(key, value);
+        return url.toString();
+    } catch  {
+        const hashIndex = rawUrl.indexOf("#");
+        const hash = -1 === hashIndex ? "" : rawUrl.slice(hashIndex);
+        const beforeHash = -1 === hashIndex ? rawUrl : rawUrl.slice(0, hashIndex);
+        const queryIndex = beforeHash.indexOf("?");
+        const path = -1 === queryIndex ? beforeHash : beforeHash.slice(0, queryIndex);
+        const search = new URLSearchParams(-1 === queryIndex ? "" : beforeHash.slice(queryIndex + 1));
+        for (const [key, value] of params)search.set(key, value);
+        const query = search.toString();
+        return `${path}${"" === query ? "" : `?${query}`}${hash}`;
+    }
+}
+__webpack_require__.d(__webpack_exports__, {
+    createQueryParamTransformResolver: ()=>createQueryParamTransformResolver,
+    deriveVariantUrl: ()=>deriveVariantUrl
+});
+exports.createQueryParamTransformResolver = __webpack_exports__.createQueryParamTransformResolver;
+exports.deriveVariantUrl = __webpack_exports__.deriveVariantUrl;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createQueryParamTransformResolver",
+    "deriveVariantUrl"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});