@motion-core/motion-gpu 0.6.0 → 0.8.0

package/README.md

@@ -3,6 +3,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Svelte](https://img.shields.io/badge/Svelte-5-orange.svg)](https://svelte.dev)
 [![React](https://img.shields.io/badge/React-18%2B-149eca.svg)](https://react.dev)
+[![Vue](https://img.shields.io/badge/Vue-3-42b883.svg)](https://vuejs.org)
 [![WebGPU](https://img.shields.io/badge/Shaders-WGSL-blueviolet.svg)](https://gpuweb.github.io/gpuweb/)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.9.3-blue.svg)](https://www.typescriptlang.org)
 [![npm](https://img.shields.io/badge/npm-@motion--core%2Fmotion--gpu-red.svg)](https://www.npmjs.com/package/@motion-core/motion-gpu)
@@ -13,7 +14,7 @@
 
 **A tiny WebGPU runtime for writing Shadertoy-style fullscreen shaders in pure WGSL.**
 
-`@motion-core/motion-gpu` ships a framework-agnostic core plus Svelte 5 and React adapters for building fullscreen shader pipelines using WebGPU and WGSL.
+`@motion-core/motion-gpu` ships a framework-agnostic core plus Svelte 5, React, and Vue adapters for building fullscreen shader pipelines using WebGPU and WGSL.
 It provides a minimal runtime loop, scheduler, and render graph designed specifically for fragment-driven GPU programs.
 
 Unlike general-purpose 3D engines, Motion GPU focuses on a very narrow problem: **running fullscreen fragment shaders and multi-pass GPU pipelines**.
@@ -100,6 +101,7 @@ Motion GPU follows a simple three-step flow:
 - `defineMaterial`
 - `useMotionGPU`
 - `useFrame`
+- `usePointer`
 - `useTexture`
 - `ShaderPass`
 - `BlitPass`
@@ -134,6 +136,7 @@ Also exports runtime/core types:
 - `defineMaterial`
 - `useMotionGPU`
 - `useFrame`
+- `usePointer`
 - `useTexture`
 - `ShaderPass`
 - `BlitPass`
@@ -161,6 +164,41 @@ Also exports runtime/core types:
 
 ---
 
+## Vue adapter
+
+`@motion-core/motion-gpu/vue` exposes the runtime API for Vue:
+
+- `FragCanvas`
+- `defineMaterial`
+- `useMotionGPU`
+- `useFrame`
+- `usePointer`
+- `useTexture`
+- `ShaderPass`
+- `BlitPass`
+- `CopyPass`
+- `ComputePass`
+- `PingPongComputePass`
+
+Also exports runtime/core types:
+
+- uniforms
+- textures
+- render passes
+- scheduler
+- loader types
+
+---
+
+`@motion-core/motion-gpu/vue/advanced` re-exports everything above, plus:
+
+- `useMotionGPUUserContext`
+- `setMotionGPUUserContext`
+- `applySchedulerPreset`
+- `captureSchedulerDebugSnapshot`
+
+---
+
 ## Framework-agnostic core
 
 `@motion-core/motion-gpu` (and explicit alias `@motion-core/motion-gpu/core`) exposes adapter-building primitives:
@@ -189,6 +227,7 @@ Also exports runtime/core types:
 
 - Svelte 5 is required only for the Svelte adapter entrypoints (`/svelte`, `/svelte/advanced`)
 - React 18+ is required only for the React adapter entrypoints (`/react`, `/react/advanced`)
+- Vue 3.5+ is required only for the Vue adapter entrypoints (`/vue`, `/vue/advanced`)
 - A browser/runtime with WebGPU support
 - Secure context (`https://` or `localhost`)
 

package/dist/core/pointer.d.ts

@@ -0,0 +1,96 @@
+import type { RenderMode } from './types.js';
+/**
+ * Pointer kind normalized from DOM `PointerEvent.pointerType`.
+ */
+export type PointerKind = 'mouse' | 'pen' | 'touch';
+/**
+ * 2D tuple used by pointer coordinate payloads.
+ */
+export type PointerVec2 = [number, number];
+/**
+ * Normalized pointer coordinates exposed to runtime hooks.
+ */
+export interface PointerPoint {
+    /**
+     * CSS pixel coordinates relative to canvas top-left corner.
+     */
+    px: PointerVec2;
+    /**
+     * UV coordinates in shader-friendly orientation (`y` grows upward).
+     */
+    uv: PointerVec2;
+    /**
+     * Normalized device coordinates (`-1..1`, `y` grows upward).
+     */
+    ndc: PointerVec2;
+}
+/**
+ * Mutable pointer state snapshot exposed by `usePointer`.
+ */
+export interface PointerState extends PointerPoint {
+    inside: boolean;
+    pressed: boolean;
+    dragging: boolean;
+    pointerType: PointerKind | null;
+    pointerId: number | null;
+    button: number | null;
+    buttons: number;
+    time: number;
+    downPx: PointerVec2 | null;
+    downUv: PointerVec2 | null;
+    deltaPx: PointerVec2;
+    deltaUv: PointerVec2;
+    velocityPx: PointerVec2;
+    velocityUv: PointerVec2;
+}
+/**
+ * Modifier key snapshot attached to pointer click events.
+ */
+export interface PointerModifiers {
+    alt: boolean;
+    ctrl: boolean;
+    shift: boolean;
+    meta: boolean;
+}
+/**
+ * Click/tap payload produced by `usePointer`.
+ */
+export interface PointerClick extends PointerPoint {
+    id: number;
+    time: number;
+    pointerType: PointerKind;
+    pointerId: number;
+    button: number;
+    modifiers: PointerModifiers;
+}
+/**
+ * Frame wake-up strategy for pointer-driven interactions.
+ */
+export type PointerFrameRequestMode = 'advance' | 'auto' | 'invalidate' | 'none';
+/**
+ * Returns a monotonic timestamp in seconds.
+ */
+export declare function getPointerNowSeconds(): number;
+/**
+ * Creates the initial pointer state snapshot.
+ */
+export declare function createInitialPointerState(): PointerState;
+/**
+ * Normalized coordinate payload for a pointer position against a canvas rect.
+ */
+export interface PointerCoordinates extends PointerPoint {
+    inside: boolean;
+}
+/**
+ * Converts client coordinates to canvas-relative pointer coordinates.
+ */
+export declare function getPointerCoordinates(clientX: number, clientY: number, rect: Pick<DOMRectReadOnly, 'height' | 'left' | 'top' | 'width'>): PointerCoordinates;
+/**
+ * Resolves frame wake-up strategy for pointer-driven updates.
+ */
+export declare function resolvePointerFrameRequestMode(mode: PointerFrameRequestMode, renderMode: RenderMode): Exclude<PointerFrameRequestMode, 'auto'>;
+/**
+ * Normalizes unknown pointer kind values to the public `PointerKind`.
+ */
+export declare function normalizePointerKind(pointerType: string): PointerKind;
+//# sourceMappingURL=pointer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../src/lib/core/pointer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAChB;;OAEG;IACH,EAAE,EAAE,WAAW,CAAC;IAChB;;OAEG;IACH,GAAG,EAAE,WAAW,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,WAAW,CAAC;IACxB,UAAU,EAAE,WAAW,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,YAAY;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,gBAAgB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC;AAEjF;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAM7C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,YAAY,CAoBxD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACvD,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,GAC9D,kBAAkB,CAgBpB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC7C,IAAI,EAAE,uBAAuB,EAC7B,UAAU,EAAE,UAAU,GACpB,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAc1C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAMrE"}

package/dist/core/pointer.js

@@ -0,0 +1,71 @@
+//#region src/lib/core/pointer.ts
+/**
+* Returns a monotonic timestamp in seconds.
+*/
+function getPointerNowSeconds() {
+	if (typeof performance !== "undefined" && typeof performance.now === "function") return performance.now() / 1e3;
+	return Date.now() / 1e3;
+}
+/**
+* Creates the initial pointer state snapshot.
+*/
+function createInitialPointerState() {
+	return {
+		px: [0, 0],
+		uv: [0, 0],
+		ndc: [-1, -1],
+		inside: false,
+		pressed: false,
+		dragging: false,
+		pointerType: null,
+		pointerId: null,
+		button: null,
+		buttons: 0,
+		time: getPointerNowSeconds(),
+		downPx: null,
+		downUv: null,
+		deltaPx: [0, 0],
+		deltaUv: [0, 0],
+		velocityPx: [0, 0],
+		velocityUv: [0, 0]
+	};
+}
+/**
+* Converts client coordinates to canvas-relative pointer coordinates.
+*/
+function getPointerCoordinates(clientX, clientY, rect) {
+	const width = Math.max(rect.width, 1);
+	const height = Math.max(rect.height, 1);
+	const nx = (clientX - rect.left) / width;
+	const ny = (clientY - rect.top) / height;
+	const pxX = clientX - rect.left;
+	const pxY = clientY - rect.top;
+	const uvX = nx;
+	const uvY = 1 - ny;
+	return {
+		px: [pxX, pxY],
+		uv: [uvX, uvY],
+		ndc: [nx * 2 - 1, uvY * 2 - 1],
+		inside: nx >= 0 && nx <= 1 && ny >= 0 && ny <= 1
+	};
+}
+/**
+* Resolves frame wake-up strategy for pointer-driven updates.
+*/
+function resolvePointerFrameRequestMode(mode, renderMode) {
+	if (mode !== "auto") return mode;
+	if (renderMode === "manual") return "advance";
+	if (renderMode === "on-demand") return "invalidate";
+	return "none";
+}
+/**
+* Normalizes unknown pointer kind values to the public `PointerKind`.
+*/
+function normalizePointerKind(pointerType) {
+	if (pointerType === "mouse" || pointerType === "pen" || pointerType === "touch") return pointerType;
+	return "mouse";
+}
+//#endregion
+export { createInitialPointerState, getPointerCoordinates, getPointerNowSeconds, normalizePointerKind, resolvePointerFrameRequestMode };
+
+//# sourceMappingURL=pointer.js.map

package/dist/core/pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.js","names":[],"sources":["../../src/lib/core/pointer.ts"],"sourcesContent":["import type { RenderMode } from './types.js';\n\n/**\n * Pointer kind normalized from DOM `PointerEvent.pointerType`.\n */\nexport type PointerKind = 'mouse' | 'pen' | 'touch';\n\n/**\n * 2D tuple used by pointer coordinate payloads.\n */\nexport type PointerVec2 = [number, number];\n\n/**\n * Normalized pointer coordinates exposed to runtime hooks.\n */\nexport interface PointerPoint {\n\t/**\n\t * CSS pixel coordinates relative to canvas top-left corner.\n\t */\n\tpx: PointerVec2;\n\t/**\n\t * UV coordinates in shader-friendly orientation (`y` grows upward).\n\t */\n\tuv: PointerVec2;\n\t/**\n\t * Normalized device coordinates (`-1..1`, `y` grows upward).\n\t */\n\tndc: PointerVec2;\n}\n\n/**\n * Mutable pointer state snapshot exposed by `usePointer`.\n */\nexport interface PointerState extends PointerPoint {\n\tinside: boolean;\n\tpressed: boolean;\n\tdragging: boolean;\n\tpointerType: PointerKind | null;\n\tpointerId: number | null;\n\tbutton: number | null;\n\tbuttons: number;\n\ttime: number;\n\tdownPx: PointerVec2 | null;\n\tdownUv: PointerVec2 | null;\n\tdeltaPx: PointerVec2;\n\tdeltaUv: PointerVec2;\n\tvelocityPx: PointerVec2;\n\tvelocityUv: PointerVec2;\n}\n\n/**\n * Modifier key snapshot attached to pointer click events.\n */\nexport interface PointerModifiers {\n\talt: boolean;\n\tctrl: boolean;\n\tshift: boolean;\n\tmeta: boolean;\n}\n\n/**\n * Click/tap payload produced by `usePointer`.\n */\nexport interface PointerClick extends PointerPoint {\n\tid: number;\n\ttime: number;\n\tpointerType: PointerKind;\n\tpointerId: number;\n\tbutton: number;\n\tmodifiers: PointerModifiers;\n}\n\n/**\n * Frame wake-up strategy for pointer-driven interactions.\n */\nexport type PointerFrameRequestMode = 'advance' | 'auto' | 'invalidate' | 'none';\n\n/**\n * Returns a monotonic timestamp in seconds.\n */\nexport function getPointerNowSeconds(): number {\n\tif (typeof performance !== 'undefined' && typeof performance.now === 'function') {\n\t\treturn performance.now() / 1000;\n\t}\n\n\treturn Date.now() / 1000;\n}\n\n/**\n * Creates the initial pointer state snapshot.\n */\nexport function createInitialPointerState(): PointerState {\n\treturn {\n\t\tpx: [0, 0],\n\t\tuv: [0, 0],\n\t\tndc: [-1, -1],\n\t\tinside: false,\n\t\tpressed: false,\n\t\tdragging: false,\n\t\tpointerType: null,\n\t\tpointerId: null,\n\t\tbutton: null,\n\t\tbuttons: 0,\n\t\ttime: getPointerNowSeconds(),\n\t\tdownPx: null,\n\t\tdownUv: null,\n\t\tdeltaPx: [0, 0],\n\t\tdeltaUv: [0, 0],\n\t\tvelocityPx: [0, 0],\n\t\tvelocityUv: [0, 0]\n\t};\n}\n\n/**\n * Normalized coordinate payload for a pointer position against a canvas rect.\n */\nexport interface PointerCoordinates extends PointerPoint {\n\tinside: boolean;\n}\n\n/**\n * Converts client coordinates to canvas-relative pointer coordinates.\n */\nexport function getPointerCoordinates(\n\tclientX: number,\n\tclientY: number,\n\trect: Pick<DOMRectReadOnly, 'height' | 'left' | 'top' | 'width'>\n): PointerCoordinates {\n\tconst width = Math.max(rect.width, 1);\n\tconst height = Math.max(rect.height, 1);\n\tconst nx = (clientX - rect.left) / width;\n\tconst ny = (clientY - rect.top) / height;\n\tconst pxX = clientX - rect.left;\n\tconst pxY = clientY - rect.top;\n\tconst uvX = nx;\n\tconst uvY = 1 - ny;\n\n\treturn {\n\t\tpx: [pxX, pxY],\n\t\tuv: [uvX, uvY],\n\t\tndc: [nx * 2 - 1, uvY * 2 - 1],\n\t\tinside: nx >= 0 && nx <= 1 && ny >= 0 && ny <= 1\n\t};\n}\n\n/**\n * Resolves frame wake-up strategy for pointer-driven updates.\n */\nexport function resolvePointerFrameRequestMode(\n\tmode: PointerFrameRequestMode,\n\trenderMode: RenderMode\n): Exclude<PointerFrameRequestMode, 'auto'> {\n\tif (mode !== 'auto') {\n\t\treturn mode;\n\t}\n\n\tif (renderMode === 'manual') {\n\t\treturn 'advance';\n\t}\n\n\tif (renderMode === 'on-demand') {\n\t\treturn 'invalidate';\n\t}\n\n\treturn 'none';\n}\n\n/**\n * Normalizes unknown pointer kind values to the public `PointerKind`.\n */\nexport function normalizePointerKind(pointerType: string): PointerKind {\n\tif (pointerType === 'mouse' || pointerType === 'pen' || pointerType === 'touch') {\n\t\treturn pointerType;\n\t}\n\n\treturn 'mouse';\n}\n"],"mappings":";;;;AAgFA,SAAgB,uBAA+B;AAC9C,KAAI,OAAO,gBAAgB,eAAe,OAAO,YAAY,QAAQ,WACpE,QAAO,YAAY,KAAK,GAAG;AAG5B,QAAO,KAAK,KAAK,GAAG;;;;;AAMrB,SAAgB,4BAA0C;AACzD,QAAO;EACN,IAAI,CAAC,GAAG,EAAE;EACV,IAAI,CAAC,GAAG,EAAE;EACV,KAAK,CAAC,IAAI,GAAG;EACb,QAAQ;EACR,SAAS;EACT,UAAU;EACV,aAAa;EACb,WAAW;EACX,QAAQ;EACR,SAAS;EACT,MAAM,sBAAsB;EAC5B,QAAQ;EACR,QAAQ;EACR,SAAS,CAAC,GAAG,EAAE;EACf,SAAS,CAAC,GAAG,EAAE;EACf,YAAY,CAAC,GAAG,EAAE;EAClB,YAAY,CAAC,GAAG,EAAE;EAClB;;;;;AAaF,SAAgB,sBACf,SACA,SACA,MACqB;CACrB,MAAM,QAAQ,KAAK,IAAI,KAAK,OAAO,EAAE;CACrC,MAAM,SAAS,KAAK,IAAI,KAAK,QAAQ,EAAE;CACvC,MAAM,MAAM,UAAU,KAAK,QAAQ;CACnC,MAAM,MAAM,UAAU,KAAK,OAAO;CAClC,MAAM,MAAM,UAAU,KAAK;CAC3B,MAAM,MAAM,UAAU,KAAK;CAC3B,MAAM,MAAM;CACZ,MAAM,MAAM,IAAI;AAEhB,QAAO;EACN,IAAI,CAAC,KAAK,IAAI;EACd,IAAI,CAAC,KAAK,IAAI;EACd,KAAK,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,EAAE;EAC9B,QAAQ,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM;EAC/C;;;;;AAMF,SAAgB,+BACf,MACA,YAC2C;AAC3C,KAAI,SAAS,OACZ,QAAO;AAGR,KAAI,eAAe,SAClB,QAAO;AAGR,KAAI,eAAe,YAClB,QAAO;AAGR,QAAO;;;;;AAMR,SAAgB,qBAAqB,aAAkC;AACtE,KAAI,gBAAgB,WAAW,gBAAgB,SAAS,gBAAgB,QACvE,QAAO;AAGR,QAAO"}

package/dist/motion-gpu.css

@@ -0,0 +1,295 @@
+
+.motiongpu-error-overlay {
+	--motiongpu-base-hue: var(--base-hue, 265);
+	--motiongpu-color-background: oklch(0.2178 0.0056 var(--motiongpu-base-hue));
+	--motiongpu-color-background-muted: oklch(0.261 0.007 var(--motiongpu-base-hue));
+	--motiongpu-color-foreground: oklch(1 0 0);
+	--motiongpu-color-foreground-muted: oklch(0.6699 0.0081 var(--motiongpu-base-hue));
+	--motiongpu-color-card: var(--motiongpu-color-background);
+	--motiongpu-color-accent: oklch(0.6996 0.181959 44.4414);
+	--motiongpu-color-accent-secondary: oklch(0.5096 0.131959 44.4414);
+	--motiongpu-color-border: oklch(0.928 0.013 var(--motiongpu-base-hue) / 0.05);
+	--motiongpu-color-white-fixed: oklch(1 0 0);
+	--motiongpu-shadow-card: var(
+		--shadow-2xl,
+		0px 1px 1px -0.5px rgba(0, 0, 0, 0.06),
+		0px 3px 3px -1.5px rgba(0, 0, 0, 0.06),
+		0px 6px 6px -3px rgba(0, 0, 0, 0.06),
+		0px 12px 12px -6px rgba(0, 0, 0, 0.06),
+		0px 24px 24px -12px rgba(0, 0, 0, 0.05),
+		0px 48px 48px -24px rgba(0, 0, 0, 0.06)
+	);
+	--motiongpu-radius-md: var(--radius-md, 0.5rem);
+	--motiongpu-radius-lg: var(--radius-lg, 0.75rem);
+	--motiongpu-radius-xl: var(--radius-xl, 1rem);
+	--motiongpu-font-sans: var(--font-sans, 'Inter', 'Segoe UI', 'Helvetica Neue', Arial, sans-serif);
+	--motiongpu-font-mono: var(--font-mono, 'SFMono-Regular', 'Menlo', 'Consolas', monospace);
+	position: fixed;
+	inset: 0;
+	display: grid;
+	place-items: center;
+	padding: clamp(0.75rem, 1.4vw, 1.5rem);
+	background: rgba(0, 0, 0, 0.8);
+	backdrop-filter: blur(10px);
+	z-index: 2147483647;
+	font-family: var(--motiongpu-font-sans);
+	color-scheme: dark;
+}
+.motiongpu-error-dialog {
+	width: min(52rem, calc(100vw - 1.5rem));
+	max-height: min(84vh, 44rem);
+	overflow: auto;
+	margin: 0;
+	padding: 1.1rem;
+	border: 1px solid var(--motiongpu-color-border);
+	border-radius: var(--motiongpu-radius-xl);
+	max-width: calc(100vw - 1.5rem);
+	box-sizing: border-box;
+	font-size: 0.875rem;
+	font-weight: 400;
+	line-height: 1.45;
+	background: var(--motiongpu-color-card);
+	color: var(--motiongpu-color-foreground);
+	box-shadow: var(--motiongpu-shadow-card);
+}
+.motiongpu-error-header {
+	display: grid;
+	gap: 0.55rem;
+	padding-bottom: 0.9rem;
+	border-bottom: 1px solid var(--motiongpu-color-border);
+}
+.motiongpu-error-header-top {
+	display: flex;
+	align-items: flex-start;
+	gap: 0.75rem;
+}
+.motiongpu-error-badges {
+	display: inline-flex;
+	align-items: center;
+	gap: 0.4rem;
+	flex-wrap: wrap;
+}
+.motiongpu-error-badge-wrap {
+	display: inline-flex;
+	align-items: center;
+	gap: 0.4rem;
+	width: fit-content;
+	padding: 0.18rem;
+	border-radius: 999px;
+	border: 1px solid var(--motiongpu-color-border);
+	background: var(--motiongpu-color-background-muted);
+}
+.motiongpu-error-badge {
+	display: inline-flex;
+	align-items: center;
+	margin: 0;
+	padding: 0.22rem 0.56rem;
+	border-radius: 999px;
+	font-size: 0.66rem;
+	letter-spacing: 0.08em;
+	line-height: 1;
+	font-weight: 500;
+	text-transform: uppercase;
+	color: var(--motiongpu-color-white-fixed);
+	background: linear-gradient(
+		180deg,
+		var(--motiongpu-color-accent) 0%,
+		var(--motiongpu-color-accent-secondary) 100%
+	);
+	box-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.24);
+}
+.motiongpu-error-recoverable {
+	margin: 0;
+	font-size: 0.67rem;
+	line-height: 1.2;
+	letter-spacing: 0.06em;
+	text-transform: uppercase;
+	color: var(--motiongpu-color-foreground-muted);
+}
+.motiongpu-error-recoverable span {
+	font-family: var(--motiongpu-font-mono);
+	color: var(--motiongpu-color-foreground);
+}
+.motiongpu-error-title {
+	margin: 0;
+	font-size: clamp(1.02rem, 1vw + 0.72rem, 1.32rem);
+	font-weight: 500;
+	line-height: 1.18;
+	letter-spacing: -0.02em;
+	text-wrap: balance;
+	color: var(--motiongpu-color-foreground);
+}
+.motiongpu-error-body {
+	display: grid;
+	gap: 0.62rem;
+	margin-top: 0.92rem;
+}
+.motiongpu-error-message {
+	margin: 0;
+	padding: 0.72rem 0.78rem;
+	border: 1px solid color-mix(in oklch, var(--motiongpu-color-accent) 28%, transparent);
+	border-radius: var(--motiongpu-radius-md);
+	background: color-mix(in oklch, var(--motiongpu-color-accent) 10%, transparent);
+	font-size: 0.82rem;
+	line-height: 1.4;
+	font-weight: 400;
+	color: var(--motiongpu-color-foreground);
+}
+.motiongpu-error-hint {
+	margin: 0;
+	font-size: 0.82rem;
+	line-height: 1.45;
+	font-weight: 400;
+	color: var(--motiongpu-color-foreground-muted);
+}
+.motiongpu-error-sections {
+	display: grid;
+	gap: 0.62rem;
+	margin-top: 0.95rem;
+}
+.motiongpu-error-source {
+	display: grid;
+	gap: 0.48rem;
+	margin-top: 0.96rem;
+}
+.motiongpu-error-source-title {
+	margin: 0;
+	font-size: 0.8rem;
+	font-weight: 500;
+	line-height: 1.3;
+	letter-spacing: 0.045em;
+	text-transform: uppercase;
+	color: var(--motiongpu-color-foreground);
+}
+.motiongpu-error-source-frame {
+	border: 1px solid var(--motiongpu-color-border);
+	border-radius: var(--motiongpu-radius-lg);
+	overflow: hidden;
+	background: var(--motiongpu-color-background-muted);
+}
+.motiongpu-error-source-tabs {
+	display: flex;
+	align-items: stretch;
+	border-bottom: 1px solid var(--motiongpu-color-border);
+	background: var(--motiongpu-color-background);
+}
+.motiongpu-error-source-tab {
+	display: inline-flex;
+	align-items: center;
+	padding: 0.5rem 0.68rem;
+	font-size: 0.76rem;
+	font-weight: 400;
+	line-height: 1.2;
+	color: var(--motiongpu-color-foreground-muted);
+	border-right: 1px solid var(--motiongpu-color-border);
+}
+.motiongpu-error-source-tab-active {
+	color: var(--motiongpu-color-foreground);
+	background: var(--motiongpu-color-background-muted);
+}
+.motiongpu-error-source-tab-spacer {
+	flex: 1 1 auto;
+}
+.motiongpu-error-source-snippet {
+	display: grid;
+	background: var(--motiongpu-color-background-muted);
+}
+.motiongpu-error-source-row {
+	display: grid;
+	grid-template-columns: 2rem minmax(0, 1fr);
+	align-items: start;
+	gap: 0.42rem;
+	padding: 0.2rem 0.68rem;
+}
+.motiongpu-error-source-row-active {
+	background: color-mix(in oklch, var(--motiongpu-color-accent) 10%, transparent);
+}
+.motiongpu-error-source-line {
+	font-family: var(--motiongpu-font-mono);
+	font-size: 0.77rem;
+	font-weight: 400;
+	line-height: 1.3;
+	font-variant-numeric: tabular-nums;
+	font-feature-settings: 'tnum' 1;
+	border-right: 1px solid var(--motiongpu-color-border);
+	color: var(--motiongpu-color-foreground-muted);
+	text-align: left;
+}
+.motiongpu-error-source-code {
+	font-family: var(--motiongpu-font-mono);
+	font-size: 0.77rem;
+	font-weight: 400;
+	line-height: 1.3;
+	color: var(--motiongpu-color-foreground);
+	white-space: pre-wrap;
+	word-break: break-word;
+}
+.motiongpu-error-details {
+	border: 1px solid var(--motiongpu-color-border);
+	border-radius: var(--motiongpu-radius-lg);
+	overflow: hidden;
+	background: var(--motiongpu-color-background);
+}
+.motiongpu-error-details summary {
+	cursor: pointer;
+	padding: 0.56rem 0.68rem;
+	font-size: 0.7rem;
+	letter-spacing: 0.07em;
+	line-height: 1.2;
+	font-weight: 500;
+	text-transform: uppercase;
+	color: var(--motiongpu-color-foreground);
+}
+.motiongpu-error-details[open] summary {
+	border-bottom: 1px solid var(--motiongpu-color-border);
+}
+.motiongpu-error-details pre {
+	margin: 0;
+	padding: 0.62rem 0.68rem;
+	white-space: pre-wrap;
+	word-break: break-word;
+	overflow: auto;
+	background: var(--motiongpu-color-background-muted);
+	font-size: 0.74rem;
+	line-height: 1.4;
+	font-weight: 400;
+	color: var(--motiongpu-color-foreground);
+	font-family: var(--motiongpu-font-mono);
+}
+@media (max-width: 42rem) {
+.motiongpu-error-overlay {
+		padding: 0.62rem;
+}
+.motiongpu-error-dialog {
+		padding: 0.85rem;
+}
+.motiongpu-error-title {
+		font-size: 1.02rem;
+}
+.motiongpu-error-header-top {
+		flex-direction: column;
+		align-items: flex-start;
+}
+}
+@media (prefers-reduced-motion: reduce) {
+.motiongpu-error-overlay {
+		backdrop-filter: none;
+}
+}
+
+.motiongpu-canvas-wrap {
+	position: relative;
+	width: 100%;
+	height: 100%;
+	min-width: 0;
+	min-height: 0;
+	overflow: hidden;
+}
+.motiongpu-canvas-wrap > canvas {
+	position: absolute;
+	inset: 0;
+	display: block;
+	width: 100%;
+	height: 100%;
+}
+/*$vite$:1*/

package/dist/react/advanced.js

@@ -8,7 +8,8 @@ import { applySchedulerPreset, captureSchedulerDebugSnapshot } from "../core/sch
 import { useMotionGPU } from "./motiongpu-context.js";
 import { useFrame } from "./frame-context.js";
 import { FragCanvas } from "./FragCanvas.js";
+import { usePointer } from "./use-pointer.js";
 import { useTexture } from "./use-texture.js";
 import "./index.js";
 import { setMotionGPUUserContext, useMotionGPUUserContext, useSetMotionGPUUserContext } from "./use-motiongpu-user-context.js";
-export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, applySchedulerPreset, captureSchedulerDebugSnapshot, defineMaterial, setMotionGPUUserContext, useFrame, useMotionGPU, useMotionGPUUserContext, useSetMotionGPUUserContext, useTexture };
+export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, applySchedulerPreset, captureSchedulerDebugSnapshot, defineMaterial, setMotionGPUUserContext, useFrame, useMotionGPU, useMotionGPUUserContext, usePointer, useSetMotionGPUUserContext, useTexture };

package/dist/react/index.d.ts

@@ -6,12 +6,14 @@ export { defineMaterial } from '../core/material.js';
 export { BlitPass, CopyPass, ShaderPass, ComputePass, PingPongComputePass } from '../passes/index.js';
 export { useMotionGPU } from './motiongpu-context.js';
 export { useFrame } from './frame-context.js';
+export { usePointer } from './use-pointer.js';
 export { useTexture } from './use-texture.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 { PointerClick, PointerFrameRequestMode, PointerKind, PointerPoint, PointerState, UsePointerOptions, UsePointerResult } from './use-pointer.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';

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

@@ -1 +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"}
+{"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,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,EACX,YAAY,EACZ,uBAAuB,EACvB,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,MAAM,kBAAkB,CAAC;AAC1B,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

@@ -8,5 +8,6 @@ import "../passes/index.js";
 import { useMotionGPU } from "./motiongpu-context.js";
 import { useFrame } from "./frame-context.js";
 import { FragCanvas } from "./FragCanvas.js";
+import { usePointer } from "./use-pointer.js";
 import { useTexture } from "./use-texture.js";
-export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, defineMaterial, useFrame, useMotionGPU, useTexture };
+export { BlitPass, ComputePass, CopyPass, FragCanvas, PingPongComputePass, ShaderPass, defineMaterial, useFrame, useMotionGPU, usePointer, useTexture };