@motion-core/motion-gpu 0.4.1 → 0.5.0

package/dist/react/index.d.ts

@@ -3,13 +3,17 @@
  */
 export { FragCanvas } from './FragCanvas.js';
 export { defineMaterial } from '../core/material.js';
-export { BlitPass, CopyPass, ShaderPass } from '../passes/index.js';
+export { BlitPass, CopyPass, ShaderPass, ComputePass, PingPongComputePass } from '../passes/index.js';
 export { useMotionGPU } from './motiongpu-context.js';
 export { useFrame } from './frame-context.js';
 export { useTexture } from './use-texture.js';
-export type { FrameInvalidationToken, FrameState, OutputColorSpace, RenderPass, RenderPassContext, RenderPassFlags, RenderPassInputSlot, RenderPassOutputSlot, RenderMode, RenderTarget, RenderTargetDefinition, RenderTargetDefinitionMap, TextureData, TextureDefinition, TextureDefinitionMap, TextureUpdateMode, TextureMap, TextureSource, TextureValue, TypedUniform, UniformMat4Value, UniformMap, UniformType, UniformValue } from '../core/types.js';
+export type { FrameInvalidationToken, FrameState, OutputColorSpace, AnyPass, ComputePassLike, RenderPass, RenderPassContext, RenderPassFlags, RenderPassInputSlot, RenderPassOutputSlot, RenderMode, RenderTarget, RenderTargetDefinition, RenderTargetDefinitionMap, TextureData, TextureDefinition, TextureDefinitionMap, TextureUpdateMode, TextureMap, TextureSource, TextureValue, TypedUniform, UniformMat4Value, UniformMap, UniformType, UniformValue } from '../core/types.js';
 export type { LoadedTexture, TextureDecodeOptions, TextureLoadOptions } from '../core/texture-loader.js';
 export type { FragMaterial, FragMaterialInput, MaterialIncludes, MaterialDefineValue, MaterialDefines, TypedMaterialDefineValue } from '../core/material.js';
 export type { MotionGPUContext } from './motiongpu-context.js';
 export type { UseFrameOptions, UseFrameResult } from './frame-context.js';
 export type { TextureUrlInput, UseTextureResult } from './use-texture.js';
+export type { StorageBufferAccess, StorageBufferDefinition, StorageBufferDefinitionMap, StorageBufferType, ComputePassContext } from '../core/types.js';
+export type { ComputePassOptions, ComputeDispatchContext } from '../passes/ComputePass.js';
+export type { PingPongComputePassOptions } from '../passes/PingPongComputePass.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lib/react/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACN,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACX,sBAAsB,EACtB,UAAU,EACV,gBAAgB,EAChB,OAAO,EACP,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,WAAW,EACX,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,EACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACX,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACX,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,YAAY,EACX,mBAAmB,EACnB,uBAAuB,EACvB,0BAA0B,EAC1B,iBAAiB,EACjB,kBAAkB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,YAAY,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/react/index.js

@@ -1,9 +1,12 @@
-/**
- * React adapter entrypoint for MotionGPU.
- */
-export { FragCanvas } from './FragCanvas.js';
-export { defineMaterial } from '../core/material.js';
-export { BlitPass, CopyPass, ShaderPass } from '../passes/index.js';
-export { useMotionGPU } from './motiongpu-context.js';
-export { useFrame } from './frame-context.js';
-export { useTexture } from './use-texture.js';
+import { defineMaterial } from "../core/material.js";
+import { BlitPass } from "../passes/BlitPass.js";
+import { CopyPass } from "../passes/CopyPass.js";
+import { ShaderPass } from "../passes/ShaderPass.js";
+import { ComputePass } from "../passes/ComputePass.js";
+import { PingPongComputePass } from "../passes/PingPongComputePass.js";
+import "../passes/index.js";
+import { useMotionGPU } from "./motiongpu-context.js";
+import { useFrame } from "./frame-context.js";
+import { FragCanvas } from "./FragCanvas.js";
+import { useTexture } from "./use-texture.js";
+export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, defineMaterial, useFrame, useMotionGPU, useTexture };

package/dist/react/motiongpu-context.d.ts

@@ -71,3 +71,4 @@ export declare const MotionGPUReactContext: import("react").Context<MotionGPUCon
  * @throws {Error} When called outside `<FragCanvas>`.
  */
 export declare function useMotionGPU(): MotionGPUContext;
+//# sourceMappingURL=motiongpu-context.d.ts.map

package/dist/react/motiongpu-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"motiongpu-context.d.ts","sourceRoot":"","sources":["../../src/lib/react/motiongpu-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,KAAK,EACX,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,IAAI,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,MAAM,EAAE,iBAAiB,GAAG,SAAS,CAAC;IACtC;;OAEG;IACH,IAAI,EAAE,eAAe,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD;;OAEG;IACH,GAAG,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAClC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;IACxC;;OAEG;IACH,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACrC;;OAEG;IACH,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB;;OAEG;IACH,SAAS,EAAE,kBAAkB,CAAC;CAC9B;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,eAAe,EAAE,qBAAqB,EAAE,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,eAAe,CAAC,MAAM,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,qBAAqB,kDAA+C,CAAC;AAElF;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,gBAAgB,CAO/C"}

package/dist/react/motiongpu-context.js

@@ -1,18 +1,21 @@
-import { createContext, useContext } from 'react';
+import { createContext, useContext } from "react";
+//#region src/lib/react/motiongpu-context.ts
 /**
- * Internal React context container.
- */
-export const MotionGPUReactContext = createContext(null);
+* Internal React context container.
+*/
+var MotionGPUReactContext = createContext(null);
 /**
- * Returns active MotionGPU runtime context.
- *
- * @returns Active context.
- * @throws {Error} When called outside `<FragCanvas>`.
- */
-export function useMotionGPU() {
-    const context = useContext(MotionGPUReactContext);
-    if (!context) {
-        throw new Error('useMotionGPU must be used inside <FragCanvas>');
-    }
-    return context;
+* Returns active MotionGPU runtime context.
+*
+* @returns Active context.
+* @throws {Error} When called outside `<FragCanvas>`.
+*/
+function useMotionGPU() {
+	const context = useContext(MotionGPUReactContext);
+	if (!context) throw new Error("useMotionGPU must be used inside <FragCanvas>");
+	return context;
 }
+//#endregion
+export { MotionGPUReactContext, useMotionGPU };
+
+//# sourceMappingURL=motiongpu-context.js.map

package/dist/react/motiongpu-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"motiongpu-context.js","names":[],"sources":["../../src/lib/react/motiongpu-context.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { RenderMode } from '../core/types.js';\nimport type { CurrentReadable, CurrentWritable } from '../core/current-value.js';\nimport type {\n\tFrameProfilingSnapshot,\n\tFrameRunTimings,\n\tFrameScheduleSnapshot\n} from '../core/frame-registry.js';\nimport type { MotionGPUScheduler as CoreMotionGPUScheduler } from '../core/scheduler-helpers.js';\n\n/**\n * React context payload exposed by `<FragCanvas>`.\n */\nexport interface MotionGPUContext {\n\t/**\n\t * Underlying canvas element used by the renderer.\n\t */\n\tcanvas: HTMLCanvasElement | undefined;\n\t/**\n\t * Reactive canvas pixel size.\n\t */\n\tsize: CurrentReadable<{ width: number; height: number }>;\n\t/**\n\t * Device pixel ratio multiplier.\n\t */\n\tdpr: CurrentWritable<number>;\n\t/**\n\t * Max frame delta clamp passed to scheduled callbacks.\n\t */\n\tmaxDelta: CurrentWritable<number>;\n\t/**\n\t * Scheduler render mode (`always`, `on-demand`, `manual`).\n\t */\n\trenderMode: CurrentWritable<RenderMode>;\n\t/**\n\t * Global toggle for automatic rendering.\n\t */\n\tautoRender: CurrentWritable<boolean>;\n\t/**\n\t * Namespaced user context store shared within the canvas subtree.\n\t */\n\tuser: MotionGPUUserContext;\n\t/**\n\t * Marks current frame as invalidated.\n\t */\n\tinvalidate: () => void;\n\t/**\n\t * Requests one manual frame advance.\n\t */\n\tadvance: () => void;\n\t/**\n\t * Public scheduler API.\n\t */\n\tscheduler: MotionGPUScheduler;\n}\n\nexport type MotionGPUScheduler = CoreMotionGPUScheduler;\nexport type { FrameProfilingSnapshot, FrameRunTimings, FrameScheduleSnapshot };\n\n/**\n * Namespace identifier for user-owned context entries.\n */\nexport type MotionGPUUserNamespace = string | symbol;\n\n/**\n * Shared user context store exposed by `FragCanvas`.\n */\nexport type MotionGPUUserContext = CurrentWritable<Record<MotionGPUUserNamespace, unknown>>;\n\n/**\n * Internal React context container.\n */\nexport const MotionGPUReactContext = createContext<MotionGPUContext | null>(null);\n\n/**\n * Returns active MotionGPU runtime context.\n *\n * @returns Active context.\n * @throws {Error} When called outside `<FragCanvas>`.\n */\nexport function useMotionGPU(): MotionGPUContext {\n\tconst context = useContext(MotionGPUReactContext);\n\tif (!context) {\n\t\tthrow new Error('useMotionGPU must be used inside <FragCanvas>');\n\t}\n\n\treturn context;\n}\n"],"mappings":";;;;;AAwEA,IAAa,wBAAwB,cAAuC,KAAK;;;;;;;AAQjF,SAAgB,eAAiC;CAChD,MAAM,UAAU,WAAW,sBAAsB;AACjD,KAAI,CAAC,QACJ,OAAM,IAAI,MAAM,gDAAgD;AAGjE,QAAO"}

package/dist/react/use-motiongpu-user-context.d.ts

@@ -47,3 +47,4 @@ export declare function useSetMotionGPUUserContext(): <UCT = unknown>(namespace:
  */
 export declare function setMotionGPUUserContext<UCT = unknown>(namespace: MotionGPUUserNamespace, value: UCT | (() => UCT), options?: SetMotionGPUUserContextOptions): UCT | undefined;
 export {};
+//# sourceMappingURL=use-motiongpu-user-context.d.ts.map

package/dist/react/use-motiongpu-user-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-motiongpu-user-context.d.ts","sourceRoot":"","sources":["../../src/lib/react/use-motiongpu-user-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAGN,KAAK,sBAAsB,EAC3B,MAAM,wBAAwB,CAAC;AAEhC;;GAEG;AACH,KAAK,gBAAgB,GAAG,MAAM,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;AAOhE;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC9C;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACxC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;CACpC;AA2DD;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,EAAE,SAAS,gBAAgB,GAAG,gBAAgB,KAC1C,eAAe,CAAC,EAAE,CAAC,CAAC;AAEzB;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,EAAE,SAAS,gBAAgB,GAAG,gBAAgB,EAC9C,CAAC,SAAS,MAAM,EAAE,GAAG,sBAAsB,GAAG,MAAM,EAAE,GAAG,sBAAsB,EAC9E,SAAS,EAAE,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;AA8CpD;;;;GAIG;AACH,wBAAgB,0BAA0B,KAGvC,GAAG,uBACQ,sBAAsB,SAC1B,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,YACd,8BAA8B,KACtC,GAAG,GAAG,SAAS,CAGnB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,GAAG,OAAO,EACpD,SAAS,EAAE,sBAAsB,EACjC,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,EACxB,OAAO,CAAC,EAAE,8BAA8B,GACtC,GAAG,GAAG,SAAS,CAEjB"}

package/dist/react/use-motiongpu-user-context.js

@@ -1,94 +1,95 @@
-import { useCallback, useMemo } from 'react';
-import { useMotionGPU } from './motiongpu-context.js';
+import { useMotionGPU } from "./motiongpu-context.js";
+import { useCallback, useMemo } from "react";
+//#region src/lib/react/use-motiongpu-user-context.ts
 /**
- * Checks whether a value is a non-array object suitable for shallow merge.
- */
+* Checks whether a value is a non-array object suitable for shallow merge.
+*/
 function isObjectEntry(value) {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
+	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 /**
- * Sets a namespaced user context value in the provided user store.
- *
- * Returns the effective value stored under the namespace.
- */
+* Sets a namespaced user context value in the provided user store.
+*
+* Returns the effective value stored under the namespace.
+*/
 function setMotionGPUUserContextInStore(userStore, namespace, value, options) {
-    const mode = options?.existing ?? 'skip';
-    const functionValueMode = options?.functionValue ?? 'factory';
-    let resolvedValue;
-    userStore.update((context) => {
-        const hasExisting = namespace in context;
-        if (hasExisting && mode === 'skip') {
-            resolvedValue = context[namespace];
-            return context;
-        }
-        const nextValue = typeof value === 'function' && functionValueMode === 'factory'
-            ? value()
-            : value;
-        if (hasExisting && mode === 'merge') {
-            const currentValue = context[namespace];
-            if (isObjectEntry(currentValue) && isObjectEntry(nextValue)) {
-                resolvedValue = {
-                    ...currentValue,
-                    ...nextValue
-                };
-                return {
-                    ...context,
-                    [namespace]: resolvedValue
-                };
-            }
-        }
-        resolvedValue = nextValue;
-        return {
-            ...context,
-            [namespace]: nextValue
-        };
-    });
-    return resolvedValue;
+	const mode = options?.existing ?? "skip";
+	const functionValueMode = options?.functionValue ?? "factory";
+	let resolvedValue;
+	userStore.update((context) => {
+		const hasExisting = namespace in context;
+		if (hasExisting && mode === "skip") {
+			resolvedValue = context[namespace];
+			return context;
+		}
+		const nextValue = typeof value === "function" && functionValueMode === "factory" ? value() : value;
+		if (hasExisting && mode === "merge") {
+			const currentValue = context[namespace];
+			if (isObjectEntry(currentValue) && isObjectEntry(nextValue)) {
+				resolvedValue = {
+					...currentValue,
+					...nextValue
+				};
+				return {
+					...context,
+					[namespace]: resolvedValue
+				};
+			}
+		}
+		resolvedValue = nextValue;
+		return {
+			...context,
+			[namespace]: nextValue
+		};
+	});
+	return resolvedValue;
 }
 /**
- * Read-only user context hook:
- * - no args: returns full user context store
- * - namespace: returns namespaced store view
- *
- * @param namespace - Optional namespace key.
- */
-export function useMotionGPUUserContext(namespace) {
-    const userStore = useMotionGPU().user;
-    const allStore = useMemo(() => ({
-        get current() {
-            return userStore.current;
-        },
-        subscribe(run) {
-            return userStore.subscribe((context) => run(context));
-        }
-    }), [userStore]);
-    const scopedStore = useMemo(() => ({
-        get current() {
-            return userStore.current[namespace];
-        },
-        subscribe(run) {
-            return userStore.subscribe((context) => run(context[namespace]));
-        }
-    }), [namespace, userStore]);
-    if (namespace === undefined) {
-        return allStore;
-    }
-    return scopedStore;
+* Read-only user context hook:
+* - no args: returns full user context store
+* - namespace: returns namespaced store view
+*
+* @param namespace - Optional namespace key.
+*/
+function useMotionGPUUserContext(namespace) {
+	const userStore = useMotionGPU().user;
+	const allStore = useMemo(() => ({
+		get current() {
+			return userStore.current;
+		},
+		subscribe(run) {
+			return userStore.subscribe((context) => run(context));
+		}
+	}), [userStore]);
+	const scopedStore = useMemo(() => ({
+		get current() {
+			return userStore.current[namespace];
+		},
+		subscribe(run) {
+			return userStore.subscribe((context) => run(context[namespace]));
+		}
+	}), [namespace, userStore]);
+	if (namespace === void 0) return allStore;
+	return scopedStore;
 }
 /**
- * Returns a stable setter bound to the active MotionGPU user context store.
- *
- * @returns Setter function that preserves namespace write semantics.
- */
-export function useSetMotionGPUUserContext() {
-    const userStore = useMotionGPU().user;
-    return useCallback((namespace, value, options) => setMotionGPUUserContextInStore(userStore, namespace, value, options), [userStore]);
+* Returns a stable setter bound to the active MotionGPU user context store.
+*
+* @returns Setter function that preserves namespace write semantics.
+*/
+function useSetMotionGPUUserContext() {
+	const userStore = useMotionGPU().user;
+	return useCallback((namespace, value, options) => setMotionGPUUserContextInStore(userStore, namespace, value, options), [userStore]);
 }
 /**
- * Sets a namespaced user context value with explicit write semantics.
- *
- * Returns the effective value stored under the namespace.
- */
-export function setMotionGPUUserContext(namespace, value, options) {
-    return setMotionGPUUserContextInStore(useMotionGPU().user, namespace, value, options);
+* Sets a namespaced user context value with explicit write semantics.
+*
+* Returns the effective value stored under the namespace.
+*/
+function setMotionGPUUserContext(namespace, value, options) {
+	return setMotionGPUUserContextInStore(useMotionGPU().user, namespace, value, options);
 }
+//#endregion
+export { setMotionGPUUserContext, useMotionGPUUserContext, useSetMotionGPUUserContext };
+
+//# sourceMappingURL=use-motiongpu-user-context.js.map

package/dist/react/use-motiongpu-user-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-motiongpu-user-context.js","names":[],"sources":["../../src/lib/react/use-motiongpu-user-context.ts"],"sourcesContent":["import { useCallback, useMemo } from 'react';\nimport type { CurrentReadable } from '../core/current-value.js';\nimport {\n\tuseMotionGPU,\n\ttype MotionGPUUserContext,\n\ttype MotionGPUUserNamespace\n} from './motiongpu-context.js';\n\n/**\n * Internal shape of the user context store.\n */\ntype UserContextStore = Record<MotionGPUUserNamespace, unknown>;\n\n/**\n * Object-like context payload used by merge semantics.\n */\ntype UserContextEntry = Record<string, unknown>;\n\n/**\n * Controls how a namespaced user context value behaves when already present.\n */\nexport interface SetMotionGPUUserContextOptions {\n\t/**\n\t * Conflict strategy when namespace already exists:\n\t * - `skip`: keep current value\n\t * - `replace`: replace current value\n\t * - `merge`: shallow merge object values, fallback to replace otherwise\n\t *\n\t * @default 'skip'\n\t */\n\texisting?: 'merge' | 'replace' | 'skip';\n\t/**\n\t * How function inputs should be interpreted:\n\t * - `factory`: call function and store its return value\n\t * - `value`: store function itself\n\t *\n\t * @default 'factory'\n\t */\n\tfunctionValue?: 'factory' | 'value';\n}\n\n/**\n * Checks whether a value is a non-array object suitable for shallow merge.\n */\nfunction isObjectEntry(value: unknown): value is UserContextEntry {\n\treturn typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\n/**\n * Sets a namespaced user context value in the provided user store.\n *\n * Returns the effective value stored under the namespace.\n */\nfunction setMotionGPUUserContextInStore<UCT = unknown>(\n\tuserStore: MotionGPUUserContext,\n\tnamespace: MotionGPUUserNamespace,\n\tvalue: UCT | (() => UCT),\n\toptions?: SetMotionGPUUserContextOptions\n): UCT | undefined {\n\tconst mode = options?.existing ?? 'skip';\n\tconst functionValueMode = options?.functionValue ?? 'factory';\n\tlet resolvedValue: UCT | undefined;\n\n\tuserStore.update((context) => {\n\t\tconst hasExisting = namespace in context;\n\t\tif (hasExisting && mode === 'skip') {\n\t\t\tresolvedValue = context[namespace] as UCT | undefined;\n\t\t\treturn context;\n\t\t}\n\n\t\tconst nextValue =\n\t\t\ttypeof value === 'function' && functionValueMode === 'factory'\n\t\t\t\t? (value as () => UCT)()\n\t\t\t\t: (value as UCT);\n\t\tif (hasExisting && mode === 'merge') {\n\t\t\tconst currentValue = context[namespace];\n\t\t\tif (isObjectEntry(currentValue) && isObjectEntry(nextValue)) {\n\t\t\t\tresolvedValue = {\n\t\t\t\t\t...currentValue,\n\t\t\t\t\t...nextValue\n\t\t\t\t} as UCT;\n\t\t\t\treturn {\n\t\t\t\t\t...context,\n\t\t\t\t\t[namespace]: resolvedValue\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\tresolvedValue = nextValue;\n\t\treturn {\n\t\t\t...context,\n\t\t\t[namespace]: nextValue\n\t\t};\n\t});\n\n\treturn resolvedValue;\n}\n\n/**\n * Returns a read-only view of the entire motiongpu user context store.\n */\nexport function useMotionGPUUserContext<\n\tUC extends UserContextStore = UserContextStore\n>(): CurrentReadable<UC>;\n\n/**\n * Reads a namespaced user context value as a reactive readable store.\n */\nexport function useMotionGPUUserContext<\n\tUC extends UserContextStore = UserContextStore,\n\tK extends keyof UC & MotionGPUUserNamespace = keyof UC & MotionGPUUserNamespace\n>(namespace: K): CurrentReadable<UC[K] | undefined>;\n\n/**\n * Read-only user context hook:\n * - no args: returns full user context store\n * - namespace: returns namespaced store view\n *\n * @param namespace - Optional namespace key.\n */\nexport function useMotionGPUUserContext<\n\tUC extends UserContextStore = UserContextStore,\n\tK extends keyof UC & MotionGPUUserNamespace = keyof UC & MotionGPUUserNamespace\n>(namespace?: K): CurrentReadable<UC> | CurrentReadable<UC[K] | undefined> {\n\tconst userStore = useMotionGPU().user;\n\tconst allStore = useMemo<CurrentReadable<UC>>(\n\t\t() => ({\n\t\t\tget current() {\n\t\t\t\treturn userStore.current as UC;\n\t\t\t},\n\t\t\tsubscribe(run) {\n\t\t\t\treturn userStore.subscribe((context) => run(context as UC));\n\t\t\t}\n\t\t}),\n\t\t[userStore]\n\t);\n\tconst scopedStore = useMemo<CurrentReadable<UC[K] | undefined>>(\n\t\t() => ({\n\t\t\tget current() {\n\t\t\t\treturn userStore.current[namespace as MotionGPUUserNamespace] as UC[K] | undefined;\n\t\t\t},\n\t\t\tsubscribe(run) {\n\t\t\t\treturn userStore.subscribe((context) =>\n\t\t\t\t\trun(context[namespace as MotionGPUUserNamespace] as UC[K] | undefined)\n\t\t\t\t);\n\t\t\t}\n\t\t}),\n\t\t[namespace, userStore]\n\t);\n\n\tif (namespace === undefined) {\n\t\treturn allStore;\n\t}\n\n\treturn scopedStore;\n}\n\n/**\n * Returns a stable setter bound to the active MotionGPU user context store.\n *\n * @returns Setter function that preserves namespace write semantics.\n */\nexport function useSetMotionGPUUserContext() {\n\tconst userStore = useMotionGPU().user;\n\treturn useCallback(\n\t\t<UCT = unknown>(\n\t\t\tnamespace: MotionGPUUserNamespace,\n\t\t\tvalue: UCT | (() => UCT),\n\t\t\toptions?: SetMotionGPUUserContextOptions\n\t\t): UCT | undefined => setMotionGPUUserContextInStore(userStore, namespace, value, options),\n\t\t[userStore]\n\t);\n}\n\n/**\n * Sets a namespaced user context value with explicit write semantics.\n *\n * Returns the effective value stored under the namespace.\n */\nexport function setMotionGPUUserContext<UCT = unknown>(\n\tnamespace: MotionGPUUserNamespace,\n\tvalue: UCT | (() => UCT),\n\toptions?: SetMotionGPUUserContextOptions\n): UCT | undefined {\n\treturn setMotionGPUUserContextInStore(useMotionGPU().user, namespace, value, options);\n}\n"],"mappings":";;;;;;AA4CA,SAAS,cAAc,OAA2C;AACjE,QAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,MAAM;;;;;;;AAQ5E,SAAS,+BACR,WACA,WACA,OACA,SACkB;CAClB,MAAM,OAAO,SAAS,YAAY;CAClC,MAAM,oBAAoB,SAAS,iBAAiB;CACpD,IAAI;AAEJ,WAAU,QAAQ,YAAY;EAC7B,MAAM,cAAc,aAAa;AACjC,MAAI,eAAe,SAAS,QAAQ;AACnC,mBAAgB,QAAQ;AACxB,UAAO;;EAGR,MAAM,YACL,OAAO,UAAU,cAAc,sBAAsB,YACjD,OAAqB,GACrB;AACL,MAAI,eAAe,SAAS,SAAS;GACpC,MAAM,eAAe,QAAQ;AAC7B,OAAI,cAAc,aAAa,IAAI,cAAc,UAAU,EAAE;AAC5D,oBAAgB;KACf,GAAG;KACH,GAAG;KACH;AACD,WAAO;KACN,GAAG;MACF,YAAY;KACb;;;AAIH,kBAAgB;AAChB,SAAO;GACN,GAAG;IACF,YAAY;GACb;GACA;AAEF,QAAO;;;;;;;;;AAyBR,SAAgB,wBAGd,WAAyE;CAC1E,MAAM,YAAY,cAAc,CAAC;CACjC,MAAM,WAAW,eACT;EACN,IAAI,UAAU;AACb,UAAO,UAAU;;EAElB,UAAU,KAAK;AACd,UAAO,UAAU,WAAW,YAAY,IAAI,QAAc,CAAC;;EAE5D,GACD,CAAC,UAAU,CACX;CACD,MAAM,cAAc,eACZ;EACN,IAAI,UAAU;AACb,UAAO,UAAU,QAAQ;;EAE1B,UAAU,KAAK;AACd,UAAO,UAAU,WAAW,YAC3B,IAAI,QAAQ,WAA0D,CACtE;;EAEF,GACD,CAAC,WAAW,UAAU,CACtB;AAED,KAAI,cAAc,OACjB,QAAO;AAGR,QAAO;;;;;;;AAQR,SAAgB,6BAA6B;CAC5C,MAAM,YAAY,cAAc,CAAC;AACjC,QAAO,aAEL,WACA,OACA,YACqB,+BAA+B,WAAW,WAAW,OAAO,QAAQ,EAC1F,CAAC,UAAU,CACX;;;;;;;AAQF,SAAgB,wBACf,WACA,OACA,SACkB;AAClB,QAAO,+BAA+B,cAAc,CAAC,MAAM,WAAW,OAAO,QAAQ"}

package/dist/react/use-texture.d.ts

@@ -38,3 +38,4 @@ export type TextureUrlInput = string[] | (() => string[]);
  * @returns Reactive texture loading state with reload support.
  */
 export declare function useTexture(urlInput: TextureUrlInput, options?: TextureLoadOptions): UseTextureResult;
+//# sourceMappingURL=use-texture.d.ts.map

package/dist/react/use-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-texture.d.ts","sourceRoot":"","sources":["../../src/lib/react/use-texture.ts"],"names":[],"mappings":"AACA,OAAO,EAEN,KAAK,eAAe,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAGN,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAA0B,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC,aAAa,EAAE,GAAG,IAAI,CAAC,CAAC;IAClD;;OAEG;IACH,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACrC;;OAEG;IACH,WAAW,EAAE,eAAe,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC1D;;OAEG;IACH,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,EAAE,CAAC,CAAC;AAkE1D;;;;;;GAMG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,kBAAuB,GAC9B,gBAAgB,CAkHlB"}

package/dist/react/use-texture.js

@@ -1,162 +1,142 @@
-import { useCallback, useEffect, useRef } from 'react';
-import { createCurrentWritable as currentWritable } from '../core/current-value.js';
-import { isAbortError, loadTexturesFromUrls } from '../core/texture-loader.js';
-import { toMotionGPUErrorReport } from '../core/error-report.js';
+import { toMotionGPUErrorReport } from "../core/error-report.js";
+import { createCurrentWritable } from "../core/current-value.js";
+import { isAbortError, loadTexturesFromUrls } from "../core/texture-loader.js";
+import { useCallback, useEffect, useRef } from "react";
+//#region src/lib/react/use-texture.ts
 /**
- * Normalizes unknown thrown values to an `Error` instance.
- */
+* Normalizes unknown thrown values to an `Error` instance.
+*/
 function toError(error) {
-    if (error instanceof Error) {
-        return error;
-    }
-    return new Error('Unknown texture loading error');
+	if (error instanceof Error) return error;
+	return /* @__PURE__ */ new Error("Unknown texture loading error");
 }
 /**
- * Releases GPU-side resources for a list of loaded textures.
- */
+* Releases GPU-side resources for a list of loaded textures.
+*/
 function disposeTextures(list) {
-    for (const texture of list ?? []) {
-        texture.dispose();
-    }
+	for (const texture of list ?? []) texture.dispose();
 }
 function mergeAbortSignals(primary, secondary) {
-    if (!secondary) {
-        return {
-            signal: primary,
-            dispose: () => { }
-        };
-    }
-    if (typeof AbortSignal.any === 'function') {
-        return {
-            signal: AbortSignal.any([primary, secondary]),
-            dispose: () => { }
-        };
-    }
-    const fallback = new AbortController();
-    let disposed = false;
-    const cleanup = () => {
-        if (disposed) {
-            return;
-        }
-        disposed = true;
-        primary.removeEventListener('abort', abort);
-        secondary.removeEventListener('abort', abort);
-    };
-    const abort = () => fallback.abort();
-    primary.addEventListener('abort', abort, { once: true });
-    secondary.addEventListener('abort', abort, { once: true });
-    return {
-        signal: fallback.signal,
-        dispose: cleanup
-    };
+	if (!secondary) return {
+		signal: primary,
+		dispose: () => {}
+	};
+	if (typeof AbortSignal.any === "function") return {
+		signal: AbortSignal.any([primary, secondary]),
+		dispose: () => {}
+	};
+	const fallback = new AbortController();
+	let disposed = false;
+	const cleanup = () => {
+		if (disposed) return;
+		disposed = true;
+		primary.removeEventListener("abort", abort);
+		secondary.removeEventListener("abort", abort);
+	};
+	const abort = () => fallback.abort();
+	primary.addEventListener("abort", abort, { once: true });
+	secondary.addEventListener("abort", abort, { once: true });
+	return {
+		signal: fallback.signal,
+		dispose: cleanup
+	};
 }
 /**
- * Loads textures from URLs and exposes reactive loading/error state.
- *
- * @param urlInput - URLs array or lazy URL provider.
- * @param options - Loader options passed to URL fetch/decode pipeline.
- * @returns Reactive texture loading state with reload support.
- */
-export function useTexture(urlInput, options = {}) {
-    const texturesRef = useRef(currentWritable(null));
-    const loadingRef = useRef(currentWritable(true));
-    const errorRef = useRef(currentWritable(null));
-    const errorReportRef = useRef(currentWritable(null));
-    const activeControllerRef = useRef(null);
-    const runningLoadRef = useRef(null);
-    const reloadQueuedRef = useRef(false);
-    const requestVersionRef = useRef(0);
-    const disposedRef = useRef(false);
-    const optionsRef = useRef(options);
-    const urlInputRef = useRef(urlInput);
-    optionsRef.current = options;
-    urlInputRef.current = urlInput;
-    const getUrls = useCallback(() => {
-        const currentInput = urlInputRef.current;
-        return typeof currentInput === 'function' ? currentInput() : currentInput;
-    }, []);
-    const executeLoad = useCallback(async () => {
-        if (disposedRef.current) {
-            return;
-        }
-        const version = ++requestVersionRef.current;
-        const controller = new AbortController();
-        activeControllerRef.current = controller;
-        loadingRef.current.set(true);
-        errorRef.current.set(null);
-        errorReportRef.current.set(null);
-        const previous = texturesRef.current.current;
-        const mergedSignal = mergeAbortSignals(controller.signal, optionsRef.current.signal);
-        try {
-            const loaded = await loadTexturesFromUrls(getUrls(), {
-                ...optionsRef.current,
-                signal: mergedSignal.signal
-            });
-            if (disposedRef.current || version !== requestVersionRef.current) {
-                disposeTextures(loaded);
-                return;
-            }
-            texturesRef.current.set(loaded);
-            disposeTextures(previous);
-        }
-        catch (nextError) {
-            if (disposedRef.current || version !== requestVersionRef.current) {
-                return;
-            }
-            if (isAbortError(nextError)) {
-                return;
-            }
-            disposeTextures(previous);
-            texturesRef.current.set(null);
-            const normalizedError = toError(nextError);
-            errorRef.current.set(normalizedError);
-            errorReportRef.current.set(toMotionGPUErrorReport(normalizedError, 'initialization'));
-        }
-        finally {
-            if (!disposedRef.current && version === requestVersionRef.current) {
-                loadingRef.current.set(false);
-            }
-            if (activeControllerRef.current === controller) {
-                activeControllerRef.current = null;
-            }
-            mergedSignal.dispose();
-        }
-    }, [getUrls]);
-    const runLoadLoop = useCallback(async () => {
-        do {
-            reloadQueuedRef.current = false;
-            await executeLoad();
-        } while (reloadQueuedRef.current && !disposedRef.current);
-    }, [executeLoad]);
-    const load = useCallback(() => {
-        activeControllerRef.current?.abort();
-        if (runningLoadRef.current) {
-            reloadQueuedRef.current = true;
-            return runningLoadRef.current;
-        }
-        const pending = runLoadLoop();
-        const trackedPending = pending.finally(() => {
-            if (runningLoadRef.current === trackedPending) {
-                runningLoadRef.current = null;
-            }
-        });
-        runningLoadRef.current = trackedPending;
-        return trackedPending;
-    }, [runLoadLoop]);
-    useEffect(() => {
-        void load();
-        return () => {
-            disposedRef.current = true;
-            requestVersionRef.current += 1;
-            activeControllerRef.current?.abort();
-            disposeTextures(texturesRef.current.current);
-        };
-    }, [load]);
-    return {
-        textures: texturesRef.current,
-        loading: loadingRef.current,
-        error: errorRef.current,
-        errorReport: errorReportRef.current,
-        reload: load
-    };
+* Loads textures from URLs and exposes reactive loading/error state.
+*
+* @param urlInput - URLs array or lazy URL provider.
+* @param options - Loader options passed to URL fetch/decode pipeline.
+* @returns Reactive texture loading state with reload support.
+*/
+function useTexture(urlInput, options = {}) {
+	const texturesRef = useRef(createCurrentWritable(null));
+	const loadingRef = useRef(createCurrentWritable(true));
+	const errorRef = useRef(createCurrentWritable(null));
+	const errorReportRef = useRef(createCurrentWritable(null));
+	const activeControllerRef = useRef(null);
+	const runningLoadRef = useRef(null);
+	const reloadQueuedRef = useRef(false);
+	const requestVersionRef = useRef(0);
+	const disposedRef = useRef(false);
+	const optionsRef = useRef(options);
+	const urlInputRef = useRef(urlInput);
+	optionsRef.current = options;
+	urlInputRef.current = urlInput;
+	const getUrls = useCallback(() => {
+		const currentInput = urlInputRef.current;
+		return typeof currentInput === "function" ? currentInput() : currentInput;
+	}, []);
+	const executeLoad = useCallback(async () => {
+		if (disposedRef.current) return;
+		const version = ++requestVersionRef.current;
+		const controller = new AbortController();
+		activeControllerRef.current = controller;
+		loadingRef.current.set(true);
+		errorRef.current.set(null);
+		errorReportRef.current.set(null);
+		const previous = texturesRef.current.current;
+		const mergedSignal = mergeAbortSignals(controller.signal, optionsRef.current.signal);
+		try {
+			const loaded = await loadTexturesFromUrls(getUrls(), {
+				...optionsRef.current,
+				signal: mergedSignal.signal
+			});
+			if (disposedRef.current || version !== requestVersionRef.current) {
+				disposeTextures(loaded);
+				return;
+			}
+			texturesRef.current.set(loaded);
+			disposeTextures(previous);
+		} catch (nextError) {
+			if (disposedRef.current || version !== requestVersionRef.current) return;
+			if (isAbortError(nextError)) return;
+			disposeTextures(previous);
+			texturesRef.current.set(null);
+			const normalizedError = toError(nextError);
+			errorRef.current.set(normalizedError);
+			errorReportRef.current.set(toMotionGPUErrorReport(normalizedError, "initialization"));
+		} finally {
+			if (!disposedRef.current && version === requestVersionRef.current) loadingRef.current.set(false);
+			if (activeControllerRef.current === controller) activeControllerRef.current = null;
+			mergedSignal.dispose();
+		}
+	}, [getUrls]);
+	const runLoadLoop = useCallback(async () => {
+		do {
+			reloadQueuedRef.current = false;
+			await executeLoad();
+		} while (reloadQueuedRef.current && !disposedRef.current);
+	}, [executeLoad]);
+	const load = useCallback(() => {
+		activeControllerRef.current?.abort();
+		if (runningLoadRef.current) {
+			reloadQueuedRef.current = true;
+			return runningLoadRef.current;
+		}
+		const trackedPending = runLoadLoop().finally(() => {
+			if (runningLoadRef.current === trackedPending) runningLoadRef.current = null;
+		});
+		runningLoadRef.current = trackedPending;
+		return trackedPending;
+	}, [runLoadLoop]);
+	useEffect(() => {
+		load();
+		return () => {
+			disposedRef.current = true;
+			requestVersionRef.current += 1;
+			activeControllerRef.current?.abort();
+			disposeTextures(texturesRef.current.current);
+		};
+	}, [load]);
+	return {
+		textures: texturesRef.current,
+		loading: loadingRef.current,
+		error: errorRef.current,
+		errorReport: errorReportRef.current,
+		reload: load
+	};
 }
+//#endregion
+export { useTexture };
+
+//# sourceMappingURL=use-texture.js.map