@motion-core/motion-gpu 0.4.0 → 0.4.2

package/dist/react/frame-context.js

@@ -1,98 +1,92 @@
-import { createContext, useContext, useEffect, useRef } from 'react';
-import { createCurrentWritable } from '../core/current-value.js';
-import { useMotionGPU } from './motiongpu-context.js';
+import { createCurrentWritable } from "../core/current-value.js";
+import { useMotionGPU } from "./motiongpu-context.js";
+import { createContext, useContext, useEffect, useRef } from "react";
+//#region src/lib/react/frame-context.ts
 /**
- * Placeholder stage used before a frame task registration becomes available.
- */
-const PENDING_STAGE_KEY = Symbol('motiongpu-react-pending-stage');
+* Placeholder stage used before a frame task registration becomes available.
+*/
+var PENDING_STAGE_KEY = Symbol("motiongpu-react-pending-stage");
 /**
- * React context container for the active frame registry.
- */
-export const FrameRegistryReactContext = createContext(null);
+* React context container for the active frame registry.
+*/
+var FrameRegistryReactContext = createContext(null);
 /**
- * Registers a callback in the active frame registry and auto-unsubscribes on unmount.
- *
- * @param keyOrCallback - Task key or callback for auto-key registration.
- * @param callbackOrOptions - Callback (keyed overload) or options (auto-key overload).
- * @param maybeOptions - Optional registration options for keyed overload.
- * Registration key/options are frozen on first render; subsequent renders do not re-register.
- * @returns Registration control API with task, start/stop controls and started state.
- * @throws {Error} When called outside `<FragCanvas>`.
- * @throws {Error} When callback is missing in keyed overload.
- */
-export function useFrame(keyOrCallback, callbackOrOptions, maybeOptions) {
-    const registry = useContext(FrameRegistryReactContext);
-    if (!registry) {
-        throw new Error('useFrame must be used inside <FragCanvas>');
-    }
-    const motiongpu = useMotionGPU();
-    const resolved = typeof keyOrCallback === 'function'
-        ? {
-            key: undefined,
-            callback: keyOrCallback,
-            options: callbackOrOptions
-        }
-        : {
-            key: keyOrCallback,
-            callback: callbackOrOptions,
-            options: maybeOptions
-        };
-    if (typeof resolved.callback !== 'function') {
-        throw new Error('useFrame requires a callback');
-    }
-    const callbackRef = useRef(resolved.callback);
-    callbackRef.current = resolved.callback;
-    const registrationConfigRef = useRef(null);
-    if (!registrationConfigRef.current) {
-        registrationConfigRef.current = {
-            key: resolved.key,
-            options: resolved.options
-        };
-    }
-    const registrationConfig = registrationConfigRef.current;
-    const registrationRef = useRef(null);
-    const taskRef = useRef({
-        key: registrationConfig.key !== undefined
-            ? registrationConfig.key
-            : Symbol('motiongpu-react-pending-task-key'),
-        stage: PENDING_STAGE_KEY
-    });
-    const startedStoreRef = useRef(createCurrentWritable(false));
-    const startedStore = startedStoreRef.current;
-    useEffect(() => {
-        const wrappedCallback = (state) => {
-            callbackRef.current(state);
-        };
-        const registration = registrationConfig.key === undefined
-            ? registry.register(wrappedCallback, registrationConfig.options)
-            : registry.register(registrationConfig.key, wrappedCallback, registrationConfig.options);
-        registrationRef.current = registration;
-        taskRef.current = registration.task;
-        const unsubscribeStarted = registration.started.subscribe((value) => {
-            startedStore.set(value);
-        });
-        return () => {
-            unsubscribeStarted();
-            registration.unsubscribe();
-            if (registrationRef.current === registration) {
-                registrationRef.current = null;
-            }
-            startedStore.set(false);
-        };
-    }, [registrationConfig, registry, startedStore]);
-    useEffect(() => {
-        motiongpu.invalidate();
-    }, [motiongpu, resolved.callback]);
-    return {
-        get task() {
-            return taskRef.current;
-        },
-        start: () => {
-            registrationRef.current?.start();
-        },
-        stop: () => {
-            registrationRef.current?.stop();
-        },
-        started: startedStore
-    };
+* Registers a callback in the active frame registry and auto-unsubscribes on unmount.
+*
+* @param keyOrCallback - Task key or callback for auto-key registration.
+* @param callbackOrOptions - Callback (keyed overload) or options (auto-key overload).
+* @param maybeOptions - Optional registration options for keyed overload.
+* Registration key/options are frozen on first render; subsequent renders do not re-register.
+* @returns Registration control API with task, start/stop controls and started state.
+* @throws {Error} When called outside `<FragCanvas>`.
+* @throws {Error} When callback is missing in keyed overload.
+*/
+function useFrame(keyOrCallback, callbackOrOptions, maybeOptions) {
+	const registry = useContext(FrameRegistryReactContext);
+	if (!registry) throw new Error("useFrame must be used inside <FragCanvas>");
+	const motiongpu = useMotionGPU();
+	const resolved = typeof keyOrCallback === "function" ? {
+		key: void 0,
+		callback: keyOrCallback,
+		options: callbackOrOptions
+	} : {
+		key: keyOrCallback,
+		callback: callbackOrOptions,
+		options: maybeOptions
+	};
+	if (typeof resolved.callback !== "function") throw new Error("useFrame requires a callback");
+	const callbackRef = useRef(resolved.callback);
+	callbackRef.current = resolved.callback;
+	const registrationConfigRef = useRef(null);
+	if (!registrationConfigRef.current) registrationConfigRef.current = {
+		key: resolved.key,
+		options: resolved.options
+	};
+	const registrationConfig = registrationConfigRef.current;
+	const registrationRef = useRef(null);
+	const taskRef = useRef({
+		key: registrationConfig.key !== void 0 ? registrationConfig.key : Symbol("motiongpu-react-pending-task-key"),
+		stage: PENDING_STAGE_KEY
+	});
+	const startedStore = useRef(createCurrentWritable(false)).current;
+	useEffect(() => {
+		const wrappedCallback = (state) => {
+			callbackRef.current(state);
+		};
+		const registration = registrationConfig.key === void 0 ? registry.register(wrappedCallback, registrationConfig.options) : registry.register(registrationConfig.key, wrappedCallback, registrationConfig.options);
+		registrationRef.current = registration;
+		taskRef.current = registration.task;
+		const unsubscribeStarted = registration.started.subscribe((value) => {
+			startedStore.set(value);
+		});
+		return () => {
+			unsubscribeStarted();
+			registration.unsubscribe();
+			if (registrationRef.current === registration) registrationRef.current = null;
+			startedStore.set(false);
+		};
+	}, [
+		registrationConfig,
+		registry,
+		startedStore
+	]);
+	useEffect(() => {
+		motiongpu.invalidate();
+	}, [motiongpu, resolved.callback]);
+	return {
+		get task() {
+			return taskRef.current;
+		},
+		start: () => {
+			registrationRef.current?.start();
+		},
+		stop: () => {
+			registrationRef.current?.stop();
+		},
+		started: startedStore
+	};
 }
+//#endregion
+export { FrameRegistryReactContext, useFrame };
+
+//# sourceMappingURL=frame-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-context.js","names":[],"sources":["../../src/lib/react/frame-context.ts"],"sourcesContent":["import { createContext, useContext, useEffect, useRef } from 'react';\nimport { createCurrentWritable } from '../core/current-value.js';\nimport { useMotionGPU } from './motiongpu-context.js';\nimport type {\n\tFrameCallback,\n\tFrameKey,\n\tFrameProfilingSnapshot,\n\tFrameRegistry,\n\tFrameRunTimings,\n\tFrameScheduleSnapshot,\n\tFrameStage,\n\tFrameStageCallback,\n\tFrameTask,\n\tFrameTaskInvalidation,\n\tFrameTaskInvalidationToken,\n\tUseFrameOptions,\n\tUseFrameResult\n} from '../core/frame-registry.js';\n\n/**\n * Placeholder stage used before a frame task registration becomes available.\n */\nconst PENDING_STAGE_KEY = Symbol('motiongpu-react-pending-stage');\n\n/**\n * React context container for the active frame registry.\n */\nexport const FrameRegistryReactContext = createContext<FrameRegistry | null>(null);\n\nexport type {\n\tFrameCallback,\n\tFrameKey,\n\tFrameProfilingSnapshot,\n\tFrameRegistry,\n\tFrameRunTimings,\n\tFrameScheduleSnapshot,\n\tFrameStage,\n\tFrameStageCallback,\n\tFrameTask,\n\tFrameTaskInvalidation,\n\tFrameTaskInvalidationToken,\n\tUseFrameOptions,\n\tUseFrameResult\n};\n\n/**\n * Registers a frame callback using an auto-generated task key.\n */\nexport function useFrame(callback: FrameCallback, options?: UseFrameOptions): UseFrameResult;\n\n/**\n * Registers a frame callback with an explicit task key.\n */\nexport function useFrame(\n\tkey: FrameKey,\n\tcallback: FrameCallback,\n\toptions?: UseFrameOptions\n): UseFrameResult;\n\n/**\n * Registers a callback in the active frame registry and auto-unsubscribes on unmount.\n *\n * @param keyOrCallback - Task key or callback for auto-key registration.\n * @param callbackOrOptions - Callback (keyed overload) or options (auto-key overload).\n * @param maybeOptions - Optional registration options for keyed overload.\n * Registration key/options are frozen on first render; subsequent renders do not re-register.\n * @returns Registration control API with task, start/stop controls and started state.\n * @throws {Error} When called outside `<FragCanvas>`.\n * @throws {Error} When callback is missing in keyed overload.\n */\nexport function useFrame(\n\tkeyOrCallback: FrameKey | FrameCallback,\n\tcallbackOrOptions?: FrameCallback | UseFrameOptions,\n\tmaybeOptions?: UseFrameOptions\n): UseFrameResult {\n\tconst registry = useContext(FrameRegistryReactContext);\n\tif (!registry) {\n\t\tthrow new Error('useFrame must be used inside <FragCanvas>');\n\t}\n\tconst motiongpu = useMotionGPU();\n\n\tconst resolved =\n\t\ttypeof keyOrCallback === 'function'\n\t\t\t? {\n\t\t\t\t\tkey: undefined,\n\t\t\t\t\tcallback: keyOrCallback,\n\t\t\t\t\toptions: callbackOrOptions as UseFrameOptions | undefined\n\t\t\t\t}\n\t\t\t: {\n\t\t\t\t\tkey: keyOrCallback,\n\t\t\t\t\tcallback: callbackOrOptions as FrameCallback,\n\t\t\t\t\toptions: maybeOptions\n\t\t\t\t};\n\tif (typeof resolved.callback !== 'function') {\n\t\tthrow new Error('useFrame requires a callback');\n\t}\n\n\tconst callbackRef = useRef(resolved.callback);\n\tcallbackRef.current = resolved.callback;\n\tconst registrationConfigRef = useRef<{\n\t\tkey: FrameKey | undefined;\n\t\toptions: UseFrameOptions | undefined;\n\t} | null>(null);\n\tif (!registrationConfigRef.current) {\n\t\tregistrationConfigRef.current = {\n\t\t\tkey: resolved.key,\n\t\t\toptions: resolved.options\n\t\t};\n\t}\n\tconst registrationConfig = registrationConfigRef.current;\n\n\tconst registrationRef = useRef<{\n\t\ttask: FrameTask;\n\t\tstart: () => void;\n\t\tstop: () => void;\n\t\tstarted: UseFrameResult['started'];\n\t\tunsubscribe: () => void;\n\t} | null>(null);\n\tconst taskRef = useRef<FrameTask>({\n\t\tkey:\n\t\t\tregistrationConfig.key !== undefined\n\t\t\t\t? registrationConfig.key\n\t\t\t\t: Symbol('motiongpu-react-pending-task-key'),\n\t\tstage: PENDING_STAGE_KEY\n\t});\n\tconst startedStoreRef = useRef(createCurrentWritable(false));\n\tconst startedStore = startedStoreRef.current;\n\n\tuseEffect(() => {\n\t\tconst wrappedCallback: FrameCallback = (state) => {\n\t\t\tcallbackRef.current(state);\n\t\t};\n\t\tconst registration =\n\t\t\tregistrationConfig.key === undefined\n\t\t\t\t? registry.register(wrappedCallback, registrationConfig.options)\n\t\t\t\t: registry.register(registrationConfig.key, wrappedCallback, registrationConfig.options);\n\t\tregistrationRef.current = registration;\n\t\ttaskRef.current = registration.task;\n\t\tconst unsubscribeStarted = registration.started.subscribe((value) => {\n\t\t\tstartedStore.set(value);\n\t\t});\n\n\t\treturn () => {\n\t\t\tunsubscribeStarted();\n\t\t\tregistration.unsubscribe();\n\t\t\tif (registrationRef.current === registration) {\n\t\t\t\tregistrationRef.current = null;\n\t\t\t}\n\t\t\tstartedStore.set(false);\n\t\t};\n\t}, [registrationConfig, registry, startedStore]);\n\n\tuseEffect(() => {\n\t\tmotiongpu.invalidate();\n\t}, [motiongpu, resolved.callback]);\n\n\treturn {\n\t\tget task() {\n\t\t\treturn taskRef.current;\n\t\t},\n\t\tstart: () => {\n\t\t\tregistrationRef.current?.start();\n\t\t},\n\t\tstop: () => {\n\t\t\tregistrationRef.current?.stop();\n\t\t},\n\t\tstarted: startedStore\n\t};\n}\n"],"mappings":";;;;;;;AAsBA,IAAM,oBAAoB,OAAO,gCAAgC;;;;AAKjE,IAAa,4BAA4B,cAAoC,KAAK;;;;;;;;;;;;AA2ClF,SAAgB,SACf,eACA,mBACA,cACiB;CACjB,MAAM,WAAW,WAAW,0BAA0B;AACtD,KAAI,CAAC,SACJ,OAAM,IAAI,MAAM,4CAA4C;CAE7D,MAAM,YAAY,cAAc;CAEhC,MAAM,WACL,OAAO,kBAAkB,aACtB;EACA,KAAK;EACL,UAAU;EACV,SAAS;EACT,GACA;EACA,KAAK;EACL,UAAU;EACV,SAAS;EACT;AACJ,KAAI,OAAO,SAAS,aAAa,WAChC,OAAM,IAAI,MAAM,+BAA+B;CAGhD,MAAM,cAAc,OAAO,SAAS,SAAS;AAC7C,aAAY,UAAU,SAAS;CAC/B,MAAM,wBAAwB,OAGpB,KAAK;AACf,KAAI,CAAC,sBAAsB,QAC1B,uBAAsB,UAAU;EAC/B,KAAK,SAAS;EACd,SAAS,SAAS;EAClB;CAEF,MAAM,qBAAqB,sBAAsB;CAEjD,MAAM,kBAAkB,OAMd,KAAK;CACf,MAAM,UAAU,OAAkB;EACjC,KACC,mBAAmB,QAAQ,SACxB,mBAAmB,MACnB,OAAO,mCAAmC;EAC9C,OAAO;EACP,CAAC;CAEF,MAAM,eADkB,OAAO,sBAAsB,MAAM,CAAC,CACvB;AAErC,iBAAgB;EACf,MAAM,mBAAkC,UAAU;AACjD,eAAY,QAAQ,MAAM;;EAE3B,MAAM,eACL,mBAAmB,QAAQ,SACxB,SAAS,SAAS,iBAAiB,mBAAmB,QAAQ,GAC9D,SAAS,SAAS,mBAAmB,KAAK,iBAAiB,mBAAmB,QAAQ;AAC1F,kBAAgB,UAAU;AAC1B,UAAQ,UAAU,aAAa;EAC/B,MAAM,qBAAqB,aAAa,QAAQ,WAAW,UAAU;AACpE,gBAAa,IAAI,MAAM;IACtB;AAEF,eAAa;AACZ,uBAAoB;AACpB,gBAAa,aAAa;AAC1B,OAAI,gBAAgB,YAAY,aAC/B,iBAAgB,UAAU;AAE3B,gBAAa,IAAI,MAAM;;IAEtB;EAAC;EAAoB;EAAU;EAAa,CAAC;AAEhD,iBAAgB;AACf,YAAU,YAAY;IACpB,CAAC,WAAW,SAAS,SAAS,CAAC;AAElC,QAAO;EACN,IAAI,OAAO;AACV,UAAO,QAAQ;;EAEhB,aAAa;AACZ,mBAAgB,SAAS,OAAO;;EAEjC,YAAY;AACX,mBAAgB,SAAS,MAAM;;EAEhC,SAAS;EACT"}

package/dist/react/index.d.ts

@@ -13,3 +13,4 @@ export type { FragMaterial, FragMaterialInput, MaterialIncludes, MaterialDefineV
 export type { MotionGPUContext } from './motiongpu-context.js';
 export type { UseFrameOptions, UseFrameResult } from './frame-context.js';
 export type { TextureUrlInput, UseTextureResult } from './use-texture.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,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACpE,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,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"}

package/dist/react/index.js

@@ -1,9 +1,10 @@
-/**
- * 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 "../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, CopyPass, FragCanvas, 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"}