@motion-core/motion-gpu 0.4.0 → 0.4.2

package/dist/core/texture-loader.js

@@ -1,295 +1,227 @@
-const resourceCache = new Map();
+//#region src/lib/core/texture-loader.ts
+var resourceCache = /* @__PURE__ */ new Map();
 function createAbortError() {
-    try {
-        return new DOMException('Texture request was aborted', 'AbortError');
-    }
-    catch {
-        const error = new Error('Texture request was aborted');
-        error.name = 'AbortError';
-        return error;
-    }
+	try {
+		return new DOMException("Texture request was aborted", "AbortError");
+	} catch {
+		const error = /* @__PURE__ */ new Error("Texture request was aborted");
+		error.name = "AbortError";
+		return error;
+	}
 }
 /**
- * Checks whether error represents abort cancellation.
- */
-export function isAbortError(error) {
-    return (error instanceof Error &&
-        (error.name === 'AbortError' || error.message.toLowerCase().includes('aborted')));
+* Checks whether error represents abort cancellation.
+*/
+function isAbortError(error) {
+	return error instanceof Error && (error.name === "AbortError" || error.message.toLowerCase().includes("aborted"));
 }
 function toBodyFingerprint(body) {
-    if (body == null) {
-        return null;
-    }
-    if (typeof body === 'string') {
-        return `string:${body}`;
-    }
-    if (body instanceof URLSearchParams) {
-        return `urlsearchparams:${body.toString()}`;
-    }
-    if (typeof FormData !== 'undefined' && body instanceof FormData) {
-        const entries = Array.from(body.entries()).map(([key, value]) => `${key}:${String(value)}`);
-        return `formdata:${entries.join('&')}`;
-    }
-    if (body instanceof Blob) {
-        return `blob:${body.type}:${body.size}`;
-    }
-    if (body instanceof ArrayBuffer) {
-        return `arraybuffer:${body.byteLength}`;
-    }
-    if (ArrayBuffer.isView(body)) {
-        return `view:${body.byteLength}`;
-    }
-    return `opaque:${Object.prototype.toString.call(body)}`;
+	if (body == null) return null;
+	if (typeof body === "string") return `string:${body}`;
+	if (body instanceof URLSearchParams) return `urlsearchparams:${body.toString()}`;
+	if (typeof FormData !== "undefined" && body instanceof FormData) return `formdata:${Array.from(body.entries()).map(([key, value]) => `${key}:${String(value)}`).join("&")}`;
+	if (body instanceof Blob) return `blob:${body.type}:${body.size}`;
+	if (body instanceof ArrayBuffer) return `arraybuffer:${body.byteLength}`;
+	if (ArrayBuffer.isView(body)) return `view:${body.byteLength}`;
+	return `opaque:${Object.prototype.toString.call(body)}`;
 }
 function normalizeRequestInit(requestInit) {
-    if (!requestInit) {
-        return {};
-    }
-    const headers = new Headers(requestInit.headers);
-    const headerEntries = Array.from(headers.entries()).sort(([a], [b]) => a.localeCompare(b));
-    const normalized = {};
-    normalized.method = (requestInit.method ?? 'GET').toUpperCase();
-    normalized.mode = requestInit.mode ?? null;
-    normalized.cache = requestInit.cache ?? null;
-    normalized.credentials = requestInit.credentials ?? null;
-    normalized.redirect = requestInit.redirect ?? null;
-    normalized.referrer = requestInit.referrer ?? null;
-    normalized.referrerPolicy = requestInit.referrerPolicy ?? null;
-    normalized.integrity = requestInit.integrity ?? null;
-    normalized.keepalive = requestInit.keepalive ?? false;
-    normalized.priority = requestInit.priority ?? null;
-    normalized.headers = headerEntries;
-    normalized.body = toBodyFingerprint(requestInit.body);
-    return normalized;
+	if (!requestInit) return {};
+	const headers = new Headers(requestInit.headers);
+	const headerEntries = Array.from(headers.entries()).sort(([a], [b]) => a.localeCompare(b));
+	const normalized = {};
+	normalized.method = (requestInit.method ?? "GET").toUpperCase();
+	normalized.mode = requestInit.mode ?? null;
+	normalized.cache = requestInit.cache ?? null;
+	normalized.credentials = requestInit.credentials ?? null;
+	normalized.redirect = requestInit.redirect ?? null;
+	normalized.referrer = requestInit.referrer ?? null;
+	normalized.referrerPolicy = requestInit.referrerPolicy ?? null;
+	normalized.integrity = requestInit.integrity ?? null;
+	normalized.keepalive = requestInit.keepalive ?? false;
+	normalized.priority = requestInit.priority ?? null;
+	normalized.headers = headerEntries;
+	normalized.body = toBodyFingerprint(requestInit.body);
+	return normalized;
 }
 function normalizeTextureLoadOptions(options) {
-    const colorSpace = options.colorSpace ?? 'srgb';
-    const normalized = {
-        colorSpace,
-        decode: {
-            colorSpaceConversion: options.decode?.colorSpaceConversion ?? (colorSpace === 'linear' ? 'none' : 'default'),
-            premultiplyAlpha: options.decode?.premultiplyAlpha ?? 'default',
-            imageOrientation: options.decode?.imageOrientation ?? 'none'
-        }
-    };
-    if (options.requestInit !== undefined) {
-        normalized.requestInit = options.requestInit;
-    }
-    if (options.signal !== undefined) {
-        normalized.signal = options.signal;
-    }
-    if (options.update !== undefined) {
-        normalized.update = options.update;
-    }
-    if (options.flipY !== undefined) {
-        normalized.flipY = options.flipY;
-    }
-    if (options.premultipliedAlpha !== undefined) {
-        normalized.premultipliedAlpha = options.premultipliedAlpha;
-    }
-    if (options.generateMipmaps !== undefined) {
-        normalized.generateMipmaps = options.generateMipmaps;
-    }
-    return normalized;
+	const colorSpace = options.colorSpace ?? "srgb";
+	const normalized = {
+		colorSpace,
+		decode: {
+			colorSpaceConversion: options.decode?.colorSpaceConversion ?? (colorSpace === "linear" ? "none" : "default"),
+			premultiplyAlpha: options.decode?.premultiplyAlpha ?? "default",
+			imageOrientation: options.decode?.imageOrientation ?? "none"
+		}
+	};
+	if (options.requestInit !== void 0) normalized.requestInit = options.requestInit;
+	if (options.signal !== void 0) normalized.signal = options.signal;
+	if (options.update !== void 0) normalized.update = options.update;
+	if (options.flipY !== void 0) normalized.flipY = options.flipY;
+	if (options.premultipliedAlpha !== void 0) normalized.premultipliedAlpha = options.premultipliedAlpha;
+	if (options.generateMipmaps !== void 0) normalized.generateMipmaps = options.generateMipmaps;
+	return normalized;
 }
 /**
- * Builds deterministic resource cache key from full URL IO config.
- */
-export function buildTextureResourceCacheKey(url, options = {}) {
-    const normalized = normalizeTextureLoadOptions(options);
-    return JSON.stringify({
-        url,
-        colorSpace: normalized.colorSpace,
-        requestInit: normalizeRequestInit(normalized.requestInit),
-        decode: normalized.decode
-    });
+* Builds deterministic resource cache key from full URL IO config.
+*/
+function buildTextureResourceCacheKey(url, options = {}) {
+	const normalized = normalizeTextureLoadOptions(options);
+	return JSON.stringify({
+		url,
+		colorSpace: normalized.colorSpace,
+		requestInit: normalizeRequestInit(normalized.requestInit),
+		decode: normalized.decode
+	});
 }
 /**
- * Clears the internal texture resource cache.
- */
-export function clearTextureBlobCache() {
-    for (const entry of resourceCache.values()) {
-        if (!entry.settled) {
-            entry.controller.abort();
-        }
-    }
-    resourceCache.clear();
+* Clears the internal texture resource cache.
+*/
+function clearTextureBlobCache() {
+	for (const entry of resourceCache.values()) if (!entry.settled) entry.controller.abort();
+	resourceCache.clear();
 }
 function acquireTextureBlob(url, options) {
-    const key = buildTextureResourceCacheKey(url, options);
-    const existing = resourceCache.get(key);
-    if (existing) {
-        existing.refs += 1;
-        let released = false;
-        return {
-            entry: existing,
-            release: () => {
-                if (released) {
-                    return;
-                }
-                released = true;
-                existing.refs = Math.max(0, existing.refs - 1);
-                if (existing.refs === 0) {
-                    if (!existing.settled) {
-                        existing.controller.abort();
-                    }
-                    resourceCache.delete(key);
-                }
-            }
-        };
-    }
-    const normalized = normalizeTextureLoadOptions(options);
-    const controller = new AbortController();
-    const requestInit = {
-        ...(normalized.requestInit ?? {}),
-        signal: controller.signal
-    };
-    const entry = {
-        key,
-        refs: 1,
-        controller,
-        settled: false,
-        blobPromise: fetch(url, requestInit)
-            .then(async (response) => {
-            if (!response.ok) {
-                throw new Error(`Texture request failed (${response.status}) for ${url}`);
-            }
-            return response.blob();
-        })
-            .then((blob) => {
-            entry.settled = true;
-            return blob;
-        })
-            .catch((error) => {
-            resourceCache.delete(key);
-            throw error;
-        })
-    };
-    resourceCache.set(key, entry);
-    let released = false;
-    return {
-        entry,
-        release: () => {
-            if (released) {
-                return;
-            }
-            released = true;
-            entry.refs = Math.max(0, entry.refs - 1);
-            if (entry.refs === 0) {
-                if (!entry.settled) {
-                    entry.controller.abort();
-                }
-                resourceCache.delete(key);
-            }
-        }
-    };
+	const key = buildTextureResourceCacheKey(url, options);
+	const existing = resourceCache.get(key);
+	if (existing) {
+		existing.refs += 1;
+		let released = false;
+		return {
+			entry: existing,
+			release: () => {
+				if (released) return;
+				released = true;
+				existing.refs = Math.max(0, existing.refs - 1);
+				if (existing.refs === 0) {
+					if (!existing.settled) existing.controller.abort();
+					resourceCache.delete(key);
+				}
+			}
+		};
+	}
+	const normalized = normalizeTextureLoadOptions(options);
+	const controller = new AbortController();
+	const requestInit = {
+		...normalized.requestInit ?? {},
+		signal: controller.signal
+	};
+	const entry = {
+		key,
+		refs: 1,
+		controller,
+		settled: false,
+		blobPromise: fetch(url, requestInit).then(async (response) => {
+			if (!response.ok) throw new Error(`Texture request failed (${response.status}) for ${url}`);
+			return response.blob();
+		}).then((blob) => {
+			entry.settled = true;
+			return blob;
+		}).catch((error) => {
+			resourceCache.delete(key);
+			throw error;
+		})
+	};
+	resourceCache.set(key, entry);
+	let released = false;
+	return {
+		entry,
+		release: () => {
+			if (released) return;
+			released = true;
+			entry.refs = Math.max(0, entry.refs - 1);
+			if (entry.refs === 0) {
+				if (!entry.settled) entry.controller.abort();
+				resourceCache.delete(key);
+			}
+		}
+	};
 }
 async function awaitWithAbort(promise, signal) {
-    if (!signal) {
-        return promise;
-    }
-    if (signal.aborted) {
-        throw createAbortError();
-    }
-    return new Promise((resolve, reject) => {
-        const onAbort = () => {
-            reject(createAbortError());
-        };
-        signal.addEventListener('abort', onAbort, { once: true });
-        promise.then(resolve, reject).finally(() => {
-            signal.removeEventListener('abort', onAbort);
-        });
-    });
+	if (!signal) return promise;
+	if (signal.aborted) throw createAbortError();
+	return new Promise((resolve, reject) => {
+		const onAbort = () => {
+			reject(createAbortError());
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+		promise.then(resolve, reject).finally(() => {
+			signal.removeEventListener("abort", onAbort);
+		});
+	});
 }
 /**
- * Loads a single texture from URL and converts it to an `ImageBitmap`.
- *
- * @param url - Texture URL.
- * @param options - Loading options.
- * @returns Loaded texture object.
- * @throws {Error} When runtime does not support `createImageBitmap` or request fails.
- */
-export async function loadTextureFromUrl(url, options = {}) {
-    if (typeof createImageBitmap !== 'function') {
-        throw new Error('createImageBitmap is not available in this runtime');
-    }
-    const normalized = normalizeTextureLoadOptions(options);
-    const { entry, release } = acquireTextureBlob(url, options);
-    let bitmap = null;
-    try {
-        const blob = await awaitWithAbort(entry.blobPromise, normalized.signal);
-        const bitmapOptions = {
-            colorSpaceConversion: normalized.decode.colorSpaceConversion,
-            premultiplyAlpha: normalized.decode.premultiplyAlpha,
-            imageOrientation: normalized.decode.imageOrientation
-        };
-        const allDefaults = bitmapOptions.colorSpaceConversion === 'default' &&
-            bitmapOptions.premultiplyAlpha === 'default' &&
-            bitmapOptions.imageOrientation === 'none';
-        bitmap = allDefaults
-            ? await createImageBitmap(blob)
-            : await createImageBitmap(blob, bitmapOptions);
-        if (normalized.signal?.aborted) {
-            bitmap.close();
-            throw createAbortError();
-        }
-        const loaded = {
-            url,
-            source: bitmap,
-            width: bitmap.width,
-            height: bitmap.height,
-            colorSpace: normalized.colorSpace,
-            dispose: () => {
-                bitmap?.close();
-            }
-        };
-        if (normalized.update !== undefined) {
-            loaded.update = normalized.update;
-        }
-        if (normalized.flipY !== undefined) {
-            loaded.flipY = normalized.flipY;
-        }
-        if (normalized.premultipliedAlpha !== undefined) {
-            loaded.premultipliedAlpha = normalized.premultipliedAlpha;
-        }
-        if (normalized.generateMipmaps !== undefined) {
-            loaded.generateMipmaps = normalized.generateMipmaps;
-        }
-        return loaded;
-    }
-    catch (error) {
-        if (bitmap) {
-            bitmap.close();
-        }
-        throw error;
-    }
-    finally {
-        release();
-    }
+* Loads a single texture from URL and converts it to an `ImageBitmap`.
+*
+* @param url - Texture URL.
+* @param options - Loading options.
+* @returns Loaded texture object.
+* @throws {Error} When runtime does not support `createImageBitmap` or request fails.
+*/
+async function loadTextureFromUrl(url, options = {}) {
+	if (typeof createImageBitmap !== "function") throw new Error("createImageBitmap is not available in this runtime");
+	const normalized = normalizeTextureLoadOptions(options);
+	const { entry, release } = acquireTextureBlob(url, options);
+	let bitmap = null;
+	try {
+		const blob = await awaitWithAbort(entry.blobPromise, normalized.signal);
+		const bitmapOptions = {
+			colorSpaceConversion: normalized.decode.colorSpaceConversion,
+			premultiplyAlpha: normalized.decode.premultiplyAlpha,
+			imageOrientation: normalized.decode.imageOrientation
+		};
+		bitmap = bitmapOptions.colorSpaceConversion === "default" && bitmapOptions.premultiplyAlpha === "default" && bitmapOptions.imageOrientation === "none" ? await createImageBitmap(blob) : await createImageBitmap(blob, bitmapOptions);
+		if (normalized.signal?.aborted) {
+			bitmap.close();
+			throw createAbortError();
+		}
+		const loaded = {
+			url,
+			source: bitmap,
+			width: bitmap.width,
+			height: bitmap.height,
+			colorSpace: normalized.colorSpace,
+			dispose: () => {
+				bitmap?.close();
+			}
+		};
+		if (normalized.update !== void 0) loaded.update = normalized.update;
+		if (normalized.flipY !== void 0) loaded.flipY = normalized.flipY;
+		if (normalized.premultipliedAlpha !== void 0) loaded.premultipliedAlpha = normalized.premultipliedAlpha;
+		if (normalized.generateMipmaps !== void 0) loaded.generateMipmaps = normalized.generateMipmaps;
+		return loaded;
+	} catch (error) {
+		if (bitmap) bitmap.close();
+		throw error;
+	} finally {
+		release();
+	}
 }
 /**
- * Loads many textures in parallel from URLs.
- *
- * @param urls - Texture URLs.
- * @param options - Shared loading options.
- * @returns Promise resolving to loaded textures in input order.
- */
-export async function loadTexturesFromUrls(urls, options = {}) {
-    const settled = await Promise.allSettled(urls.map((url) => loadTextureFromUrl(url, options)));
-    const loaded = [];
-    let firstError = null;
-    for (const entry of settled) {
-        if (entry.status === 'fulfilled') {
-            loaded.push(entry.value);
-            continue;
-        }
-        firstError ??= entry.reason;
-    }
-    if (firstError) {
-        for (const texture of loaded) {
-            texture.dispose();
-        }
-        throw firstError;
-    }
-    return loaded;
+* Loads many textures in parallel from URLs.
+*
+* @param urls - Texture URLs.
+* @param options - Shared loading options.
+* @returns Promise resolving to loaded textures in input order.
+*/
+async function loadTexturesFromUrls(urls, options = {}) {
+	const settled = await Promise.allSettled(urls.map((url) => loadTextureFromUrl(url, options)));
+	const loaded = [];
+	let firstError = null;
+	for (const entry of settled) {
+		if (entry.status === "fulfilled") {
+			loaded.push(entry.value);
+			continue;
+		}
+		firstError ??= entry.reason;
+	}
+	if (firstError) {
+		for (const texture of loaded) texture.dispose();
+		throw firstError;
+	}
+	return loaded;
 }
+//#endregion
+export { buildTextureResourceCacheKey, clearTextureBlobCache, isAbortError, loadTextureFromUrl, loadTexturesFromUrls };
+
+//# sourceMappingURL=texture-loader.js.map

package/dist/core/texture-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-loader.js","names":[],"sources":["../../src/lib/core/texture-loader.ts"],"sourcesContent":["import type { TextureUpdateMode } from './types.js';\n\n/**\n * Options controlling bitmap decode behavior.\n */\nexport interface TextureDecodeOptions {\n\t/**\n\t * Controls color-space conversion during decode.\n\t */\n\tcolorSpaceConversion?: 'default' | 'none';\n\t/**\n\t * Controls alpha premultiplication during decode.\n\t */\n\tpremultiplyAlpha?: 'default' | 'none' | 'premultiply';\n\t/**\n\t * Controls bitmap orientation during decode.\n\t */\n\timageOrientation?: 'none' | 'flipY';\n}\n\n/**\n * Options controlling URL-based texture loading and decode behavior.\n */\nexport interface TextureLoadOptions {\n\t/**\n\t * Desired texture color space.\n\t */\n\tcolorSpace?: 'srgb' | 'linear';\n\t/**\n\t * Fetch options forwarded to `fetch`.\n\t */\n\trequestInit?: RequestInit;\n\t/**\n\t * Decode options forwarded to `createImageBitmap`.\n\t */\n\tdecode?: TextureDecodeOptions;\n\t/**\n\t * Optional cancellation signal for this request.\n\t */\n\tsignal?: AbortSignal;\n\t/**\n\t * Optional runtime update strategy metadata attached to loaded textures.\n\t */\n\tupdate?: TextureUpdateMode;\n\t/**\n\t * Optional runtime flip-y metadata attached to loaded textures.\n\t */\n\tflipY?: boolean;\n\t/**\n\t * Optional runtime premultiplied-alpha metadata attached to loaded textures.\n\t */\n\tpremultipliedAlpha?: boolean;\n\t/**\n\t * Optional runtime mipmap metadata attached to loaded textures.\n\t */\n\tgenerateMipmaps?: boolean;\n}\n\n/**\n * Loaded texture payload returned by URL loaders.\n */\nexport interface LoadedTexture {\n\t/**\n\t * Source URL.\n\t */\n\turl: string;\n\t/**\n\t * Decoded bitmap source.\n\t */\n\tsource: ImageBitmap;\n\t/**\n\t * Bitmap width in pixels.\n\t */\n\twidth: number;\n\t/**\n\t * Bitmap height in pixels.\n\t */\n\theight: number;\n\t/**\n\t * Effective color space.\n\t */\n\tcolorSpace: 'srgb' | 'linear';\n\t/**\n\t * Effective runtime update strategy.\n\t */\n\tupdate?: TextureUpdateMode;\n\t/**\n\t * Effective runtime flip-y metadata.\n\t */\n\tflipY?: boolean;\n\t/**\n\t * Effective runtime premultiplied-alpha metadata.\n\t */\n\tpremultipliedAlpha?: boolean;\n\t/**\n\t * Effective runtime mipmap metadata.\n\t */\n\tgenerateMipmaps?: boolean;\n\t/**\n\t * Releases bitmap resources.\n\t */\n\tdispose: () => void;\n}\n\ninterface NormalizedTextureLoadOptions {\n\tcolorSpace: 'srgb' | 'linear';\n\trequestInit?: RequestInit;\n\tdecode: Required<TextureDecodeOptions>;\n\tsignal?: AbortSignal;\n\tupdate?: TextureUpdateMode;\n\tflipY?: boolean;\n\tpremultipliedAlpha?: boolean;\n\tgenerateMipmaps?: boolean;\n}\n\ninterface TextureResourceCacheEntry {\n\tkey: string;\n\trefs: number;\n\tcontroller: AbortController;\n\tsettled: boolean;\n\tblobPromise: Promise<Blob>;\n}\n\nconst resourceCache = new Map<string, TextureResourceCacheEntry>();\n\nfunction createAbortError(): Error {\n\ttry {\n\t\treturn new DOMException('Texture request was aborted', 'AbortError');\n\t} catch {\n\t\tconst error = new Error('Texture request was aborted');\n\t\t(error as Error & { name: string }).name = 'AbortError';\n\t\treturn error;\n\t}\n}\n\n/**\n * Checks whether error represents abort cancellation.\n */\nexport function isAbortError(error: unknown): boolean {\n\treturn (\n\t\terror instanceof Error &&\n\t\t(error.name === 'AbortError' || error.message.toLowerCase().includes('aborted'))\n\t);\n}\n\nfunction toBodyFingerprint(body: BodyInit | null | undefined): string | null {\n\tif (body == null) {\n\t\treturn null;\n\t}\n\n\tif (typeof body === 'string') {\n\t\treturn `string:${body}`;\n\t}\n\n\tif (body instanceof URLSearchParams) {\n\t\treturn `urlsearchparams:${body.toString()}`;\n\t}\n\n\tif (typeof FormData !== 'undefined' && body instanceof FormData) {\n\t\tconst entries = Array.from(body.entries()).map(([key, value]) => `${key}:${String(value)}`);\n\t\treturn `formdata:${entries.join('&')}`;\n\t}\n\n\tif (body instanceof Blob) {\n\t\treturn `blob:${body.type}:${body.size}`;\n\t}\n\n\tif (body instanceof ArrayBuffer) {\n\t\treturn `arraybuffer:${body.byteLength}`;\n\t}\n\n\tif (ArrayBuffer.isView(body)) {\n\t\treturn `view:${body.byteLength}`;\n\t}\n\n\treturn `opaque:${Object.prototype.toString.call(body)}`;\n}\n\nfunction normalizeRequestInit(requestInit: RequestInit | undefined): Record<string, unknown> {\n\tif (!requestInit) {\n\t\treturn {};\n\t}\n\n\tconst headers = new Headers(requestInit.headers);\n\tconst headerEntries = Array.from(headers.entries()).sort(([a], [b]) => a.localeCompare(b));\n\tconst normalized: Record<string, unknown> = {};\n\n\tnormalized.method = (requestInit.method ?? 'GET').toUpperCase();\n\tnormalized.mode = requestInit.mode ?? null;\n\tnormalized.cache = requestInit.cache ?? null;\n\tnormalized.credentials = requestInit.credentials ?? null;\n\tnormalized.redirect = requestInit.redirect ?? null;\n\tnormalized.referrer = requestInit.referrer ?? null;\n\tnormalized.referrerPolicy = requestInit.referrerPolicy ?? null;\n\tnormalized.integrity = requestInit.integrity ?? null;\n\tnormalized.keepalive = requestInit.keepalive ?? false;\n\tnormalized.priority = requestInit.priority ?? null;\n\tnormalized.headers = headerEntries;\n\tnormalized.body = toBodyFingerprint(requestInit.body);\n\n\treturn normalized;\n}\n\nfunction normalizeTextureLoadOptions(options: TextureLoadOptions): NormalizedTextureLoadOptions {\n\tconst colorSpace = options.colorSpace ?? 'srgb';\n\n\tconst normalized: NormalizedTextureLoadOptions = {\n\t\tcolorSpace,\n\t\tdecode: {\n\t\t\tcolorSpaceConversion:\n\t\t\t\toptions.decode?.colorSpaceConversion ?? (colorSpace === 'linear' ? 'none' : 'default'),\n\t\t\tpremultiplyAlpha: options.decode?.premultiplyAlpha ?? 'default',\n\t\t\timageOrientation: options.decode?.imageOrientation ?? 'none'\n\t\t}\n\t};\n\n\tif (options.requestInit !== undefined) {\n\t\tnormalized.requestInit = options.requestInit;\n\t}\n\tif (options.signal !== undefined) {\n\t\tnormalized.signal = options.signal;\n\t}\n\tif (options.update !== undefined) {\n\t\tnormalized.update = options.update;\n\t}\n\tif (options.flipY !== undefined) {\n\t\tnormalized.flipY = options.flipY;\n\t}\n\tif (options.premultipliedAlpha !== undefined) {\n\t\tnormalized.premultipliedAlpha = options.premultipliedAlpha;\n\t}\n\tif (options.generateMipmaps !== undefined) {\n\t\tnormalized.generateMipmaps = options.generateMipmaps;\n\t}\n\n\treturn normalized;\n}\n\n/**\n * Builds deterministic resource cache key from full URL IO config.\n */\nexport function buildTextureResourceCacheKey(\n\turl: string,\n\toptions: TextureLoadOptions = {}\n): string {\n\tconst normalized = normalizeTextureLoadOptions(options);\n\treturn JSON.stringify({\n\t\turl,\n\t\tcolorSpace: normalized.colorSpace,\n\t\trequestInit: normalizeRequestInit(normalized.requestInit),\n\t\tdecode: normalized.decode\n\t});\n}\n\n/**\n * Clears the internal texture resource cache.\n */\nexport function clearTextureBlobCache(): void {\n\tfor (const entry of resourceCache.values()) {\n\t\tif (!entry.settled) {\n\t\t\tentry.controller.abort();\n\t\t}\n\t}\n\tresourceCache.clear();\n}\n\nfunction acquireTextureBlob(\n\turl: string,\n\toptions: TextureLoadOptions\n): {\n\tentry: TextureResourceCacheEntry;\n\trelease: () => void;\n} {\n\tconst key = buildTextureResourceCacheKey(url, options);\n\tconst existing = resourceCache.get(key);\n\tif (existing) {\n\t\texisting.refs += 1;\n\t\tlet released = false;\n\t\treturn {\n\t\t\tentry: existing,\n\t\t\trelease: () => {\n\t\t\t\tif (released) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\treleased = true;\n\t\t\t\texisting.refs = Math.max(0, existing.refs - 1);\n\t\t\t\tif (existing.refs === 0) {\n\t\t\t\t\tif (!existing.settled) {\n\t\t\t\t\t\texisting.controller.abort();\n\t\t\t\t\t}\n\t\t\t\t\tresourceCache.delete(key);\n\t\t\t\t}\n\t\t\t}\n\t\t};\n\t}\n\n\tconst normalized = normalizeTextureLoadOptions(options);\n\tconst controller = new AbortController();\n\tconst requestInit = {\n\t\t...(normalized.requestInit ?? {}),\n\t\tsignal: controller.signal\n\t} satisfies RequestInit;\n\tconst entry: TextureResourceCacheEntry = {\n\t\tkey,\n\t\trefs: 1,\n\t\tcontroller,\n\t\tsettled: false,\n\t\tblobPromise: fetch(url, requestInit)\n\t\t\t.then(async (response) => {\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tthrow new Error(`Texture request failed (${response.status}) for ${url}`);\n\t\t\t\t}\n\t\t\t\treturn response.blob();\n\t\t\t})\n\t\t\t.then((blob) => {\n\t\t\t\tentry.settled = true;\n\t\t\t\treturn blob;\n\t\t\t})\n\t\t\t.catch((error) => {\n\t\t\t\tresourceCache.delete(key);\n\t\t\t\tthrow error;\n\t\t\t})\n\t};\n\n\tresourceCache.set(key, entry);\n\tlet released = false;\n\treturn {\n\t\tentry,\n\t\trelease: () => {\n\t\t\tif (released) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\treleased = true;\n\t\t\tentry.refs = Math.max(0, entry.refs - 1);\n\t\t\tif (entry.refs === 0) {\n\t\t\t\tif (!entry.settled) {\n\t\t\t\t\tentry.controller.abort();\n\t\t\t\t}\n\t\t\t\tresourceCache.delete(key);\n\t\t\t}\n\t\t}\n\t};\n}\n\nasync function awaitWithAbort<T>(promise: Promise<T>, signal: AbortSignal | undefined): Promise<T> {\n\tif (!signal) {\n\t\treturn promise;\n\t}\n\n\tif (signal.aborted) {\n\t\tthrow createAbortError();\n\t}\n\n\treturn new Promise<T>((resolve, reject) => {\n\t\tconst onAbort = (): void => {\n\t\t\treject(createAbortError());\n\t\t};\n\n\t\tsignal.addEventListener('abort', onAbort, { once: true });\n\n\t\tpromise.then(resolve, reject).finally(() => {\n\t\t\tsignal.removeEventListener('abort', onAbort);\n\t\t});\n\t});\n}\n\n/**\n * Loads a single texture from URL and converts it to an `ImageBitmap`.\n *\n * @param url - Texture URL.\n * @param options - Loading options.\n * @returns Loaded texture object.\n * @throws {Error} When runtime does not support `createImageBitmap` or request fails.\n */\nexport async function loadTextureFromUrl(\n\turl: string,\n\toptions: TextureLoadOptions = {}\n): Promise<LoadedTexture> {\n\tif (typeof createImageBitmap !== 'function') {\n\t\tthrow new Error('createImageBitmap is not available in this runtime');\n\t}\n\n\tconst normalized = normalizeTextureLoadOptions(options);\n\tconst { entry, release } = acquireTextureBlob(url, options);\n\tlet bitmap: ImageBitmap | null = null;\n\n\ttry {\n\t\tconst blob = await awaitWithAbort(entry.blobPromise, normalized.signal);\n\n\t\tconst bitmapOptions: ImageBitmapOptions = {\n\t\t\tcolorSpaceConversion: normalized.decode.colorSpaceConversion,\n\t\t\tpremultiplyAlpha: normalized.decode.premultiplyAlpha,\n\t\t\timageOrientation: normalized.decode.imageOrientation\n\t\t};\n\t\tconst allDefaults =\n\t\t\tbitmapOptions.colorSpaceConversion === 'default' &&\n\t\t\tbitmapOptions.premultiplyAlpha === 'default' &&\n\t\t\tbitmapOptions.imageOrientation === 'none';\n\n\t\tbitmap = allDefaults\n\t\t\t? await createImageBitmap(blob)\n\t\t\t: await createImageBitmap(blob, bitmapOptions);\n\n\t\tif (normalized.signal?.aborted) {\n\t\t\tbitmap.close();\n\t\t\tthrow createAbortError();\n\t\t}\n\n\t\tconst loaded: LoadedTexture = {\n\t\t\turl,\n\t\t\tsource: bitmap,\n\t\t\twidth: bitmap.width,\n\t\t\theight: bitmap.height,\n\t\t\tcolorSpace: normalized.colorSpace,\n\t\t\tdispose: () => {\n\t\t\t\tbitmap?.close();\n\t\t\t}\n\t\t};\n\n\t\tif (normalized.update !== undefined) {\n\t\t\tloaded.update = normalized.update;\n\t\t}\n\t\tif (normalized.flipY !== undefined) {\n\t\t\tloaded.flipY = normalized.flipY;\n\t\t}\n\t\tif (normalized.premultipliedAlpha !== undefined) {\n\t\t\tloaded.premultipliedAlpha = normalized.premultipliedAlpha;\n\t\t}\n\t\tif (normalized.generateMipmaps !== undefined) {\n\t\t\tloaded.generateMipmaps = normalized.generateMipmaps;\n\t\t}\n\n\t\treturn loaded;\n\t} catch (error) {\n\t\tif (bitmap) {\n\t\t\tbitmap.close();\n\t\t}\n\t\tthrow error;\n\t} finally {\n\t\trelease();\n\t}\n}\n\n/**\n * Loads many textures in parallel from URLs.\n *\n * @param urls - Texture URLs.\n * @param options - Shared loading options.\n * @returns Promise resolving to loaded textures in input order.\n */\nexport async function loadTexturesFromUrls(\n\turls: string[],\n\toptions: TextureLoadOptions = {}\n): Promise<LoadedTexture[]> {\n\tconst settled = await Promise.allSettled(urls.map((url) => loadTextureFromUrl(url, options)));\n\tconst loaded: LoadedTexture[] = [];\n\tlet firstError: unknown = null;\n\n\tfor (const entry of settled) {\n\t\tif (entry.status === 'fulfilled') {\n\t\t\tloaded.push(entry.value);\n\t\t\tcontinue;\n\t\t}\n\n\t\tfirstError ??= entry.reason;\n\t}\n\n\tif (firstError) {\n\t\tfor (const texture of loaded) {\n\t\t\ttexture.dispose();\n\t\t}\n\t\tthrow firstError;\n\t}\n\n\treturn loaded;\n}\n"],"mappings":"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"}

package/dist/core/textures.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="@webgpu/types" />
 import type { TextureData, TextureDefinition, TextureDefinitionMap, TextureUpdateMode, TextureValue } from './types.js';
 /**
  * Texture definition with defaults and normalized numeric limits applied.
@@ -112,3 +113,4 @@ export declare function getTextureMipLevelCount(width: number, height: number):
  * Checks whether the source is an `HTMLVideoElement`.
  */
 export declare function isVideoTextureSource(source: TextureData['source']): source is HTMLVideoElement;
+//# sourceMappingURL=textures.d.ts.map

package/dist/core/textures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textures.d.ts","sourceRoot":"","sources":["../../src/lib/core/textures.ts"],"names":[],"mappings":";AACA,OAAO,KAAK,EACX,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IACzB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,kBAAkB,EAAE,OAAO,CAAC;IAC5B;;OAEG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IACtB;;OAEG;IACH,YAAY,EAAE,cAAc,CAAC;IAC7B;;OAEG;IACH,YAAY,EAAE,cAAc,CAAC;CAC7B;AAYD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAM3E;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,iBAAiB,GAAG,SAAS,GACvC,2BAA2B,CAmB7B;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,oBAAoB,EAC9B,WAAW,EAAE,MAAM,EAAE,GACnB,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAM7C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,KAAK,IAAI,WAAW,CAEvE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,IAAI,CAUrE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC/C,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAChC,GAAG,iBAAiB,CAcpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf,CAkBA;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAY7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,IAAI,gBAAgB,CAE9F"}