@motion-core/motion-gpu 0.4.1 → 0.5.0

package/dist/core/storage-buffers.js

@@ -0,0 +1,95 @@
+import { assertUniformName } from "./uniforms.js";
+//#region src/lib/core/storage-buffers.ts
+/**
+* Valid WGSL storage buffer element types.
+*/
+var VALID_STORAGE_BUFFER_TYPES = new Set([
+	"array<f32>",
+	"array<vec2f>",
+	"array<vec3f>",
+	"array<vec4f>",
+	"array<u32>",
+	"array<i32>",
+	"array<vec4u>",
+	"array<vec4i>"
+]);
+/**
+* Storage-compatible texture formats for `texture_storage_2d`.
+*/
+var STORAGE_TEXTURE_FORMATS = new Set([
+	"r32float",
+	"r32sint",
+	"r32uint",
+	"rg32float",
+	"rg32sint",
+	"rg32uint",
+	"rgba8unorm",
+	"rgba8snorm",
+	"rgba8uint",
+	"rgba8sint",
+	"rgba16float",
+	"rgba16uint",
+	"rgba16sint",
+	"rgba32float",
+	"rgba32uint",
+	"rgba32sint",
+	"bgra8unorm"
+]);
+/**
+* Validates a single storage buffer definition.
+*
+* @param name - Buffer identifier.
+* @param definition - Storage buffer definition to validate.
+* @throws {Error} When any field is invalid.
+*/
+function assertStorageBufferDefinition(name, definition) {
+	assertUniformName(name);
+	if (!Number.isFinite(definition.size) || definition.size <= 0) throw new Error(`Storage buffer "${name}" size must be a finite number greater than 0, got ${definition.size}`);
+	if (definition.size % 4 !== 0) throw new Error(`Storage buffer "${name}" size must be a multiple of 4, got ${definition.size}`);
+	if (!VALID_STORAGE_BUFFER_TYPES.has(definition.type)) throw new Error(`Storage buffer "${name}" has unknown type "${definition.type}". Supported types: ${[...VALID_STORAGE_BUFFER_TYPES].join(", ")}`);
+	if (definition.access !== void 0 && definition.access !== "read" && definition.access !== "read-write") throw new Error(`Storage buffer "${name}" has invalid access mode "${definition.access}". Use 'read' or 'read-write'.`);
+	if (definition.initialData !== void 0) {
+		if (definition.initialData.byteLength > definition.size) throw new Error(`Storage buffer "${name}" initialData byte length (${definition.initialData.byteLength}) exceeds buffer size (${definition.size})`);
+	}
+}
+/**
+* Validates and returns sorted storage buffer keys.
+*
+* @param definitions - Storage buffer definition map.
+* @returns Lexicographically sorted buffer keys.
+*/
+function resolveStorageBufferKeys(definitions) {
+	const keys = Object.keys(definitions).sort();
+	for (const key of keys) {
+		const definition = definitions[key];
+		if (definition) assertStorageBufferDefinition(key, definition);
+	}
+	return keys;
+}
+/**
+* Normalizes a storage buffer definition with defaults applied.
+*
+* @param definition - Raw definition.
+* @returns Normalized definition with access default.
+*/
+function normalizeStorageBufferDefinition(definition) {
+	return {
+		size: definition.size,
+		type: definition.type,
+		access: definition.access ?? "read-write"
+	};
+}
+/**
+* Validates that a texture format is storage-compatible.
+*
+* @param name - Texture identifier.
+* @param format - GPU texture format.
+* @throws {Error} When format is not storage-compatible.
+*/
+function assertStorageTextureFormat(name, format) {
+	if (!STORAGE_TEXTURE_FORMATS.has(format)) throw new Error(`Texture "${name}" with storage:true requires a storage-compatible format, but got "${format}". Supported formats: ${[...STORAGE_TEXTURE_FORMATS].join(", ")}`);
+}
+//#endregion
+export { STORAGE_TEXTURE_FORMATS, assertStorageBufferDefinition, assertStorageTextureFormat, normalizeStorageBufferDefinition, resolveStorageBufferKeys };
+
+//# sourceMappingURL=storage-buffers.js.map

package/dist/core/storage-buffers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-buffers.js","names":[],"sources":["../../src/lib/core/storage-buffers.ts"],"sourcesContent":["import { assertUniformName } from './uniforms.js';\nimport type {\n\tStorageBufferDefinition,\n\tStorageBufferDefinitionMap,\n\tStorageBufferType\n} from './types.js';\n\n/**\n * Valid WGSL storage buffer element types.\n */\nconst VALID_STORAGE_BUFFER_TYPES: ReadonlySet<string> = new Set<StorageBufferType>([\n\t'array<f32>',\n\t'array<vec2f>',\n\t'array<vec3f>',\n\t'array<vec4f>',\n\t'array<u32>',\n\t'array<i32>',\n\t'array<vec4u>',\n\t'array<vec4i>'\n]);\n\n/**\n * Storage-compatible texture formats for `texture_storage_2d`.\n */\nexport const STORAGE_TEXTURE_FORMATS: ReadonlySet<GPUTextureFormat> = new Set([\n\t'r32float',\n\t'r32sint',\n\t'r32uint',\n\t'rg32float',\n\t'rg32sint',\n\t'rg32uint',\n\t'rgba8unorm',\n\t'rgba8snorm',\n\t'rgba8uint',\n\t'rgba8sint',\n\t'rgba16float',\n\t'rgba16uint',\n\t'rgba16sint',\n\t'rgba32float',\n\t'rgba32uint',\n\t'rgba32sint',\n\t'bgra8unorm'\n] as GPUTextureFormat[]);\n\n/**\n * Validates a single storage buffer definition.\n *\n * @param name - Buffer identifier.\n * @param definition - Storage buffer definition to validate.\n * @throws {Error} When any field is invalid.\n */\nexport function assertStorageBufferDefinition(\n\tname: string,\n\tdefinition: StorageBufferDefinition\n): void {\n\tassertUniformName(name);\n\n\tif (!Number.isFinite(definition.size) || definition.size <= 0) {\n\t\tthrow new Error(\n\t\t\t`Storage buffer \"${name}\" size must be a finite number greater than 0, got ${definition.size}`\n\t\t);\n\t}\n\n\tif (definition.size % 4 !== 0) {\n\t\tthrow new Error(\n\t\t\t`Storage buffer \"${name}\" size must be a multiple of 4, got ${definition.size}`\n\t\t);\n\t}\n\n\tif (!VALID_STORAGE_BUFFER_TYPES.has(definition.type)) {\n\t\tthrow new Error(\n\t\t\t`Storage buffer \"${name}\" has unknown type \"${definition.type}\". Supported types: ${[...VALID_STORAGE_BUFFER_TYPES].join(', ')}`\n\t\t);\n\t}\n\n\tif (\n\t\tdefinition.access !== undefined &&\n\t\tdefinition.access !== 'read' &&\n\t\tdefinition.access !== 'read-write'\n\t) {\n\t\tthrow new Error(\n\t\t\t`Storage buffer \"${name}\" has invalid access mode \"${definition.access}\". Use 'read' or 'read-write'.`\n\t\t);\n\t}\n\n\tif (definition.initialData !== undefined) {\n\t\tif (definition.initialData.byteLength > definition.size) {\n\t\t\tthrow new Error(\n\t\t\t\t`Storage buffer \"${name}\" initialData byte length (${definition.initialData.byteLength}) exceeds buffer size (${definition.size})`\n\t\t\t);\n\t\t}\n\t}\n}\n\n/**\n * Validates and returns sorted storage buffer keys.\n *\n * @param definitions - Storage buffer definition map.\n * @returns Lexicographically sorted buffer keys.\n */\nexport function resolveStorageBufferKeys(definitions: StorageBufferDefinitionMap): string[] {\n\tconst keys = Object.keys(definitions).sort();\n\tfor (const key of keys) {\n\t\tconst definition = definitions[key];\n\t\tif (definition) {\n\t\t\tassertStorageBufferDefinition(key, definition);\n\t\t}\n\t}\n\treturn keys;\n}\n\n/**\n * Normalizes a storage buffer definition with defaults applied.\n *\n * @param definition - Raw definition.\n * @returns Normalized definition with access default.\n */\nexport function normalizeStorageBufferDefinition(\n\tdefinition: StorageBufferDefinition\n): Required<Pick<StorageBufferDefinition, 'size' | 'type' | 'access'>> {\n\treturn {\n\t\tsize: definition.size,\n\t\ttype: definition.type,\n\t\taccess: definition.access ?? 'read-write'\n\t};\n}\n\n/**\n * Validates that a texture format is storage-compatible.\n *\n * @param name - Texture identifier.\n * @param format - GPU texture format.\n * @throws {Error} When format is not storage-compatible.\n */\nexport function assertStorageTextureFormat(name: string, format: GPUTextureFormat): void {\n\tif (!STORAGE_TEXTURE_FORMATS.has(format)) {\n\t\tthrow new Error(\n\t\t\t`Texture \"${name}\" with storage:true requires a storage-compatible format, but got \"${format}\". ` +\n\t\t\t\t`Supported formats: ${[...STORAGE_TEXTURE_FORMATS].join(', ')}`\n\t\t);\n\t}\n}\n"],"mappings":";;;;;AAUA,IAAM,6BAAkD,IAAI,IAAuB;CAClF;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAC;;;;AAKF,IAAa,0BAAyD,IAAI,IAAI;CAC7E;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA,CAAuB;;;;;;;;AASxB,SAAgB,8BACf,MACA,YACO;AACP,mBAAkB,KAAK;AAEvB,KAAI,CAAC,OAAO,SAAS,WAAW,KAAK,IAAI,WAAW,QAAQ,EAC3D,OAAM,IAAI,MACT,mBAAmB,KAAK,qDAAqD,WAAW,OACxF;AAGF,KAAI,WAAW,OAAO,MAAM,EAC3B,OAAM,IAAI,MACT,mBAAmB,KAAK,sCAAsC,WAAW,OACzE;AAGF,KAAI,CAAC,2BAA2B,IAAI,WAAW,KAAK,CACnD,OAAM,IAAI,MACT,mBAAmB,KAAK,sBAAsB,WAAW,KAAK,sBAAsB,CAAC,GAAG,2BAA2B,CAAC,KAAK,KAAK,GAC9H;AAGF,KACC,WAAW,WAAW,UACtB,WAAW,WAAW,UACtB,WAAW,WAAW,aAEtB,OAAM,IAAI,MACT,mBAAmB,KAAK,6BAA6B,WAAW,OAAO,gCACvE;AAGF,KAAI,WAAW,gBAAgB,QAC9B;MAAI,WAAW,YAAY,aAAa,WAAW,KAClD,OAAM,IAAI,MACT,mBAAmB,KAAK,6BAA6B,WAAW,YAAY,WAAW,yBAAyB,WAAW,KAAK,GAChI;;;;;;;;;AAWJ,SAAgB,yBAAyB,aAAmD;CAC3F,MAAM,OAAO,OAAO,KAAK,YAAY,CAAC,MAAM;AAC5C,MAAK,MAAM,OAAO,MAAM;EACvB,MAAM,aAAa,YAAY;AAC/B,MAAI,WACH,+BAA8B,KAAK,WAAW;;AAGhD,QAAO;;;;;;;;AASR,SAAgB,iCACf,YACsE;AACtE,QAAO;EACN,MAAM,WAAW;EACjB,MAAM,WAAW;EACjB,QAAQ,WAAW,UAAU;EAC7B;;;;;;;;;AAUF,SAAgB,2BAA2B,MAAc,QAAgC;AACxF,KAAI,CAAC,wBAAwB,IAAI,OAAO,CACvC,OAAM,IAAI,MACT,YAAY,KAAK,qEAAqE,OAAO,wBACtE,CAAC,GAAG,wBAAwB,CAAC,KAAK,KAAK,GAC9D"}

package/dist/core/texture-loader.d.ts

@@ -127,3 +127,4 @@ export declare function loadTextureFromUrl(url: string, options?: TextureLoadOpt
  * @returns Promise resolving to loaded textures in input order.
  */
 export declare function loadTexturesFromUrls(urls: string[], options?: TextureLoadOptions): Promise<LoadedTexture[]>;
+//# sourceMappingURL=texture-loader.d.ts.map

package/dist/core/texture-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-loader.d.ts","sourceRoot":"","sources":["../../src/lib/core/texture-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,oBAAoB,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1C;;OAEG;IACH,gBAAgB,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;IACtD;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC;IACpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC9B;;OAEG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACpB;AAiCD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAKpD;AA+FD;;GAEG;AACH,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC9B,MAAM,CAQR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAO5C;AAsGD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAsExB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACzC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,kBAAuB,GAC9B,OAAO,CAAC,aAAa,EAAE,CAAC,CAsB1B"}

package/dist/core/texture-loader.js

@@ -1,295 +1,231 @@
-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();
+		}
+		let disposed = false;
+		const loaded = {
+			url,
+			source: bitmap,
+			width: bitmap.width,
+			height: bitmap.height,
+			colorSpace: normalized.colorSpace,
+			dispose: () => {
+				if (disposed) return;
+				disposed = true;
+				bitmap?.close();
+				bitmap = null;
+			}
+		};
+		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