@motion-core/motion-gpu 0.4.1 → 0.5.0

package/README.md

@@ -80,6 +80,10 @@ Motion GPU follows a simple three-step flow:
   - `BlitPass`
   - `CopyPass`
 
+- GPU compute passes:
+  - `ComputePass` — single-dispatch GPU compute workloads
+  - `PingPongComputePass` — iterative multi-step simulations with texture A/B alternation
+
 - Named render targets for multi-pass pipelines
 - Structured error normalization with built-in overlay UI and custom renderer support
 - Advanced runtime API for namespaced shared user context and scheduler presets
@@ -100,6 +104,8 @@ Motion GPU follows a simple three-step flow:
 - `ShaderPass`
 - `BlitPass`
 - `CopyPass`
+- `ComputePass`
+- `PingPongComputePass`
 
 Also exports runtime/core types:
 
@@ -132,6 +138,8 @@ Also exports runtime/core types:
 - `ShaderPass`
 - `BlitPass`
 - `CopyPass`
+- `ComputePass`
+- `PingPongComputePass`
 
 Also exports runtime/core types:
 
@@ -167,6 +175,8 @@ Also exports runtime/core types:
 - `ShaderPass`
 - `BlitPass`
 - `CopyPass`
+- `ComputePass`
+- `PingPongComputePass`
 
 `@motion-core/motion-gpu/advanced` (and explicit alias `@motion-core/motion-gpu/core/advanced`) re-exports core plus:
 
@@ -298,6 +308,84 @@ export function Runtime() {
 
 ---
 
+## 3. Add a GPU compute pass
+
+```svelte
+<!-- App.svelte -->
+<script lang="ts">
+	import { FragCanvas, defineMaterial, ComputePass } from '@motion-core/motion-gpu/svelte';
+	import Runtime from './Runtime.svelte';
+
+	const material = defineMaterial({
+		fragment: `
+fn frag(uv: vec2f) -> vec4f {
+  let idx = u32(uv.x * 255.0);
+  let particle = particles[idx];
+  return vec4f(particle.rgb, 1.0);
+}
+`,
+		storageBuffers: {
+			particles: { size: 4096, type: 'array<vec4f>', access: 'read-write' }
+		}
+	});
+
+	const simulate = new ComputePass({
+		compute: `
+@compute @workgroup_size(64)
+fn compute(@builtin(global_invocation_id) id: vec3u) {
+  let i = id.x;
+  let t = motiongpuFrame.time;
+  particles[i] = vec4f(sin(t + f32(i)), cos(t + f32(i)), 0.0, 1.0);
+}
+`,
+		dispatch: [16]
+	});
+</script>
+
+<FragCanvas {material} passes={[simulate]}>
+	<Runtime />
+</FragCanvas>
+```
+
+```tsx
+import { FragCanvas, defineMaterial, ComputePass } from '@motion-core/motion-gpu/react';
+
+const material = defineMaterial({
+	fragment: `
+fn frag(uv: vec2f) -> vec4f {
+  let idx = u32(uv.x * 255.0);
+  let particle = particles[idx];
+  return vec4f(particle.rgb, 1.0);
+}
+`,
+	storageBuffers: {
+		particles: { size: 4096, type: 'array<vec4f>', access: 'read-write' }
+	}
+});
+
+const simulate = new ComputePass({
+	compute: `
+@compute @workgroup_size(64)
+fn compute(@builtin(global_invocation_id) id: vec3u) {
+  let i = id.x;
+  let t = motiongpuFrame.time;
+  particles[i] = vec4f(sin(t + f32(i)), cos(t + f32(i)), 0.0, 1.0);
+}
+`,
+	dispatch: [16]
+});
+
+export function App() {
+	return (
+		<div style={{ width: '100vw', height: '100vh' }}>
+			<FragCanvas material={material} passes={[simulate]} />
+		</div>
+	);
+}
+```
+
+---
+
 # Core Runtime Model
 
 ## Material Phase (compile-time contract)
@@ -309,6 +397,7 @@ export function Runtime() {
 - Texture declarations
 - Compile-time `defines`
 - Shader `includes`
+- Storage buffer declarations
 
 A deterministic material signature is generated from resolved shader/layout metadata.
 
@@ -320,6 +409,8 @@ Inside `useFrame(...)` callbacks you update per-frame values:
 
 - `state.setUniform(name, value)`
 - `state.setTexture(name, value)`
+- `state.writeStorageBuffer(name, data, { offset? })`
+- `state.readStorageBuffer(name)` — returns `Promise<ArrayBuffer>`
 - `state.invalidate(token?)`
 - `state.advance()`
 
@@ -367,6 +458,14 @@ fn shade(inputColor: vec4f, uv: vec2f) -> vec4f
 
 8. `maxDelta` and profiling window must be finite and greater than `0`.
 
+9. `ComputePass` shader must contain `@compute @workgroup_size(...)` and a `fn compute(...)` entrypoint with a `@builtin(global_invocation_id)` parameter.
+
+10. `PingPongComputePass` `iterations` must be `>= 1`. The `target` must reference a texture declared with `storage: true` and explicit `width`/`height`.
+
+11. Compute passes do not participate in render pass slot routing (no `input`/`output`/`needsSwap`).
+
+12. Storage buffer `size` must be `> 0` and a multiple of 4. All storage buffers must be declared in `defineMaterial({ storageBuffers })`.
+
 ---
 
 # Pipeline Rebuild Rules

package/dist/advanced.d.ts

@@ -4,3 +4,4 @@
  * Framework-agnostic advanced core entrypoint.
  */
 export * from './core/advanced.js';
+//# sourceMappingURL=advanced.d.ts.map

package/dist/advanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../src/lib/advanced.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/advanced.js

@@ -1,6 +1,14 @@
-/**
- * Root advanced package entrypoint.
- *
- * Framework-agnostic advanced core entrypoint.
- */
-export * from './core/advanced.js';
+import { defineMaterial, resolveMaterial } from "./core/material.js";
+import { toMotionGPUErrorReport } from "./core/error-report.js";
+import { createCurrentWritable } from "./core/current-value.js";
+import { createFrameRegistry } from "./core/frame-registry.js";
+import { createMotionGPURuntimeLoop } from "./core/runtime-loop.js";
+import { loadTexturesFromUrls } from "./core/texture-loader.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 { applySchedulerPreset, captureSchedulerDebugSnapshot } from "./core/scheduler-helpers.js";
+import "./core/advanced.js";
+export { BlitPass, ComputePass, CopyPass, PingPongComputePass, ShaderPass, applySchedulerPreset, captureSchedulerDebugSnapshot, createCurrentWritable, createFrameRegistry, createMotionGPURuntimeLoop, defineMaterial, loadTexturesFromUrls, resolveMaterial, toMotionGPUErrorReport };

package/dist/core/advanced.d.ts

@@ -4,3 +4,4 @@
 export * from './index.js';
 export { applySchedulerPreset, captureSchedulerDebugSnapshot } from './scheduler-helpers.js';
 export type { ApplySchedulerPresetOptions, MotionGPUScheduler, SchedulerDebugSnapshot, SchedulerPreset, SchedulerPresetConfig } from './scheduler-helpers.js';
+//# sourceMappingURL=advanced.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"advanced.d.ts","sourceRoot":"","sources":["../../src/lib/core/advanced.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAC7F,YAAY,EACX,2BAA2B,EAC3B,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,qBAAqB,EACrB,MAAM,wBAAwB,CAAC"}

package/dist/core/advanced.js

@@ -1,5 +1,14 @@
-/**
- * Framework-agnostic advanced MotionGPU core entrypoint.
- */
-export * from './index.js';
-export { applySchedulerPreset, captureSchedulerDebugSnapshot } from './scheduler-helpers.js';
+import { defineMaterial, resolveMaterial } from "./material.js";
+import { toMotionGPUErrorReport } from "./error-report.js";
+import { createCurrentWritable } from "./current-value.js";
+import { createFrameRegistry } from "./frame-registry.js";
+import { createMotionGPURuntimeLoop } from "./runtime-loop.js";
+import { loadTexturesFromUrls } from "./texture-loader.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 "./index.js";
+import { applySchedulerPreset, captureSchedulerDebugSnapshot } from "./scheduler-helpers.js";
+export { BlitPass, ComputePass, CopyPass, PingPongComputePass, ShaderPass, applySchedulerPreset, captureSchedulerDebugSnapshot, createCurrentWritable, createFrameRegistry, createMotionGPURuntimeLoop, defineMaterial, loadTexturesFromUrls, resolveMaterial, toMotionGPUErrorReport };

package/dist/core/compute-shader.d.ts

@@ -0,0 +1,87 @@
+/// <reference types="@webgpu/types" />
+import type { StorageBufferAccess, StorageBufferType, UniformLayout } from './types.js';
+/**
+ * Regex contract for compute entrypoint.
+ * Matches: @compute @workgroup_size(...) fn compute(
+ * with @builtin(global_invocation_id) parameter.
+ */
+export declare const COMPUTE_ENTRY_CONTRACT: RegExp;
+/**
+ * Validates compute shader user code matches the compute contract.
+ *
+ * @param compute - User compute shader WGSL source.
+ * @throws {Error} When shader does not match the compute contract.
+ */
+export declare function assertComputeContract(compute: string): void;
+/**
+ * Extracts @workgroup_size values from WGSL compute shader.
+ *
+ * @param compute - Validated compute shader source.
+ * @returns Tuple [x, y, z] with defaults of 1 for omitted dimensions.
+ */
+export declare function extractWorkgroupSize(compute: string): [number, number, number];
+/**
+ * Builds storage buffer binding declarations for compute shader.
+ *
+ * @param storageBufferKeys - Sorted buffer keys.
+ * @param definitions - Type/access definitions per key.
+ * @param groupIndex - Bind group index for storage buffers.
+ * @returns WGSL binding declaration string.
+ */
+export declare function buildComputeStorageBufferBindings(storageBufferKeys: string[], definitions: Record<string, {
+    type: StorageBufferType;
+    access: StorageBufferAccess;
+}>, groupIndex: number): string;
+/**
+ * Builds storage texture binding declarations for compute shader.
+ *
+ * @param storageTextureKeys - Sorted storage texture keys.
+ * @param definitions - Format definitions per key.
+ * @param groupIndex - Bind group index for storage textures.
+ * @returns WGSL binding declaration string.
+ */
+export declare function buildComputeStorageTextureBindings(storageTextureKeys: string[], definitions: Record<string, {
+    format: GPUTextureFormat;
+}>, groupIndex: number): string;
+/**
+ * Maps storage texture format to sampled texture scalar type for `texture_2d<T>`.
+ */
+export declare function storageTextureSampleScalarType(format: GPUTextureFormat): 'f32' | 'u32' | 'i32';
+/**
+ * Assembles compute shader WGSL for ping-pong workflows.
+ *
+ * Exposes two generated bindings under group(2):
+ * - `${target}A`: sampled read texture (`texture_2d<T>`)
+ * - `${target}B`: storage write texture (`texture_storage_2d<format, write>`)
+ */
+export declare function buildPingPongComputeShaderSource(options: {
+    compute: string;
+    uniformLayout: UniformLayout;
+    storageBufferKeys: string[];
+    storageBufferDefinitions: Record<string, {
+        type: StorageBufferType;
+        access: StorageBufferAccess;
+    }>;
+    target: string;
+    targetFormat: GPUTextureFormat;
+}): string;
+/**
+ * Assembles full compute shader WGSL with preamble.
+ *
+ * @param options - Compute shader build options.
+ * @returns Complete WGSL source for compute stage.
+ */
+export declare function buildComputeShaderSource(options: {
+    compute: string;
+    uniformLayout: UniformLayout;
+    storageBufferKeys: string[];
+    storageBufferDefinitions: Record<string, {
+        type: StorageBufferType;
+        access: StorageBufferAccess;
+    }>;
+    storageTextureKeys: string[];
+    storageTextureDefinitions: Record<string, {
+        format: GPUTextureFormat;
+    }>;
+}): string;
+//# sourceMappingURL=compute-shader.d.ts.map

package/dist/core/compute-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-shader.d.ts","sourceRoot":"","sources":["../../src/lib/core/compute-shader.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,QAA+D,CAAC;AA+DnG;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAc3D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAc9E;AA2BD;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAChD,iBAAiB,EAAE,MAAM,EAAE,EAC3B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAA;CAAE,CAAC,EACrF,UAAU,EAAE,MAAM,GAChB,MAAM,CAyBR;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CACjD,kBAAkB,EAAE,MAAM,EAAE,EAC5B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAAC,EACzD,UAAU,EAAE,MAAM,GAChB,MAAM,CAwBR;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,gBAAgB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAS9F;AAED;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAC/B,MAAM,EACN;QAAE,IAAI,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CACxD,CAAC;IACF,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,gBAAgB,CAAC;CAC/B,GAAG,MAAM,CA8BT;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,aAAa,CAAC;IAC7B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAC/B,MAAM,EACN;QAAE,IAAI,EAAE,iBAAiB,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CACxD,CAAC;IACF,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAC;CACxE,GAAG,MAAM,CA8BT"}

package/dist/core/compute-shader.js

@@ -0,0 +1,205 @@
+//#region src/lib/core/compute-shader.ts
+/**
+* Regex contract for compute entrypoint.
+* Matches: @compute @workgroup_size(...) fn compute(
+* with @builtin(global_invocation_id) parameter.
+*/
+var COMPUTE_ENTRY_CONTRACT = /@compute\s+@workgroup_size\s*\([^)]+\)\s*fn\s+compute\s*\(/;
+/**
+* Regex to extract @workgroup_size values.
+*/
+var WORKGROUP_SIZE_PATTERN = /@workgroup_size\s*\(\s*(\d+)(?:\s*,\s*(\d+))?(?:\s*,\s*(\d+))?\s*\)/;
+/**
+* Regex to verify @builtin(global_invocation_id) parameter.
+*/
+var GLOBAL_INVOCATION_ID_PATTERN = /@builtin\s*\(\s*global_invocation_id\s*\)/;
+var WORKGROUP_DIMENSION_MIN = 1;
+var WORKGROUP_DIMENSION_MAX = 65535;
+function extractComputeParamList(compute) {
+	const computeFnIndex = compute.indexOf("fn compute");
+	if (computeFnIndex === -1) return null;
+	const openParenIndex = compute.indexOf("(", computeFnIndex);
+	if (openParenIndex === -1) return null;
+	let depth = 0;
+	for (let index = openParenIndex; index < compute.length; index += 1) {
+		const char = compute[index];
+		if (char === "(") {
+			depth += 1;
+			continue;
+		}
+		if (char === ")") {
+			depth -= 1;
+			if (depth === 0) return compute.slice(openParenIndex + 1, index);
+		}
+	}
+	return null;
+}
+function assertWorkgroupDimension(value) {
+	if (!Number.isFinite(value) || !Number.isInteger(value) || value < WORKGROUP_DIMENSION_MIN || value > WORKGROUP_DIMENSION_MAX) throw new Error(`@workgroup_size dimensions must be integers in range ${WORKGROUP_DIMENSION_MIN}-${WORKGROUP_DIMENSION_MAX}, got ${value}.`);
+}
+/**
+* Default uniform field used when no custom uniforms are provided in compute.
+*/
+var DEFAULT_UNIFORM_FIELD = "motiongpu_unused: vec4f,";
+/**
+* Validates compute shader user code matches the compute contract.
+*
+* @param compute - User compute shader WGSL source.
+* @throws {Error} When shader does not match the compute contract.
+*/
+function assertComputeContract(compute) {
+	if (!COMPUTE_ENTRY_CONTRACT.test(compute)) throw new Error("Compute shader must declare `@compute @workgroup_size(...) fn compute(...)`. Ensure the function is named `compute` and includes @compute and @workgroup_size annotations.");
+	const params = extractComputeParamList(compute);
+	if (!params || !GLOBAL_INVOCATION_ID_PATTERN.test(params)) throw new Error("Compute shader must include a `@builtin(global_invocation_id)` parameter.");
+	extractWorkgroupSize(compute);
+}
+/**
+* Extracts @workgroup_size values from WGSL compute shader.
+*
+* @param compute - Validated compute shader source.
+* @returns Tuple [x, y, z] with defaults of 1 for omitted dimensions.
+*/
+function extractWorkgroupSize(compute) {
+	const match = compute.match(WORKGROUP_SIZE_PATTERN);
+	if (!match) throw new Error("Could not extract @workgroup_size from compute shader source.");
+	const x = Number.parseInt(match[1] ?? "1", 10);
+	const y = Number.parseInt(match[2] ?? "1", 10);
+	const z = Number.parseInt(match[3] ?? "1", 10);
+	assertWorkgroupDimension(x);
+	assertWorkgroupDimension(y);
+	assertWorkgroupDimension(z);
+	return [
+		x,
+		y,
+		z
+	];
+}
+/**
+* Maps StorageBufferAccess to WGSL var qualifier.
+*/
+function toWgslAccessMode(access) {
+	switch (access) {
+		case "read": return "read";
+		case "read-write": return "read_write";
+		default: throw new Error(`Unsupported storage buffer access mode "${String(access)}".`);
+	}
+}
+/**
+* Builds WGSL struct fields for uniforms used in compute shader preamble.
+*/
+function buildUniformStructForCompute(layout) {
+	if (layout.entries.length === 0) return DEFAULT_UNIFORM_FIELD;
+	return layout.entries.map((entry) => `${entry.name}: ${entry.type},`).join("\n	");
+}
+/**
+* Builds storage buffer binding declarations for compute shader.
+*
+* @param storageBufferKeys - Sorted buffer keys.
+* @param definitions - Type/access definitions per key.
+* @param groupIndex - Bind group index for storage buffers.
+* @returns WGSL binding declaration string.
+*/
+function buildComputeStorageBufferBindings(storageBufferKeys, definitions, groupIndex) {
+	if (storageBufferKeys.length === 0) return "";
+	const declarations = [];
+	for (let index = 0; index < storageBufferKeys.length; index += 1) {
+		const key = storageBufferKeys[index];
+		if (key === void 0) continue;
+		const definition = definitions[key];
+		if (!definition) continue;
+		const accessMode = toWgslAccessMode(definition.access);
+		declarations.push(`@group(${groupIndex}) @binding(${index}) var<storage, ${accessMode}> ${key}: ${definition.type};`);
+	}
+	return declarations.join("\n");
+}
+/**
+* Builds storage texture binding declarations for compute shader.
+*
+* @param storageTextureKeys - Sorted storage texture keys.
+* @param definitions - Format definitions per key.
+* @param groupIndex - Bind group index for storage textures.
+* @returns WGSL binding declaration string.
+*/
+function buildComputeStorageTextureBindings(storageTextureKeys, definitions, groupIndex) {
+	if (storageTextureKeys.length === 0) return "";
+	const declarations = [];
+	for (let index = 0; index < storageTextureKeys.length; index += 1) {
+		const key = storageTextureKeys[index];
+		if (key === void 0) continue;
+		const definition = definitions[key];
+		if (!definition) continue;
+		declarations.push(`@group(${groupIndex}) @binding(${index}) var ${key}: texture_storage_2d<${definition.format}, write>;`);
+	}
+	return declarations.join("\n");
+}
+/**
+* Maps storage texture format to sampled texture scalar type for `texture_2d<T>`.
+*/
+function storageTextureSampleScalarType(format) {
+	const normalized = String(format).toLowerCase();
+	if (normalized.endsWith("uint")) return "u32";
+	if (normalized.endsWith("sint")) return "i32";
+	return "f32";
+}
+/**
+* Assembles compute shader WGSL for ping-pong workflows.
+*
+* Exposes two generated bindings under group(2):
+* - `${target}A`: sampled read texture (`texture_2d<T>`)
+* - `${target}B`: storage write texture (`texture_storage_2d<format, write>`)
+*/
+function buildPingPongComputeShaderSource(options) {
+	const uniformFields = buildUniformStructForCompute(options.uniformLayout);
+	const storageBufferBindings = buildComputeStorageBufferBindings(options.storageBufferKeys, options.storageBufferDefinitions, 1);
+	const sampledType = storageTextureSampleScalarType(options.targetFormat);
+	const pingPongTextureBindings = [`@group(2) @binding(0) var ${options.target}A: texture_2d<${sampledType}>;`, `@group(2) @binding(1) var ${options.target}B: texture_storage_2d<${options.targetFormat}, write>;`].join("\n");
+	return `struct MotionGPUFrame {
+	time: f32,
+	delta: f32,
+	resolution: vec2f,
+};
+
+struct MotionGPUUniforms {
+	${uniformFields}
+};
+
+@group(0) @binding(0) var<uniform> motiongpuFrame: MotionGPUFrame;
+@group(0) @binding(1) var<uniform> motiongpuUniforms: MotionGPUUniforms;
+${storageBufferBindings ? "\n" + storageBufferBindings : ""}
+${pingPongTextureBindings ? "\n" + pingPongTextureBindings : ""}
+
+${options.compute}
+`;
+}
+/**
+* Assembles full compute shader WGSL with preamble.
+*
+* @param options - Compute shader build options.
+* @returns Complete WGSL source for compute stage.
+*/
+function buildComputeShaderSource(options) {
+	const uniformFields = buildUniformStructForCompute(options.uniformLayout);
+	const storageBufferBindings = buildComputeStorageBufferBindings(options.storageBufferKeys, options.storageBufferDefinitions, 1);
+	const storageTextureBindings = buildComputeStorageTextureBindings(options.storageTextureKeys, options.storageTextureDefinitions, 2);
+	return `struct MotionGPUFrame {
+	time: f32,
+	delta: f32,
+	resolution: vec2f,
+};
+
+struct MotionGPUUniforms {
+	${uniformFields}
+};
+
+@group(0) @binding(0) var<uniform> motiongpuFrame: MotionGPUFrame;
+@group(0) @binding(1) var<uniform> motiongpuUniforms: MotionGPUUniforms;
+${storageBufferBindings ? "\n" + storageBufferBindings : ""}
+${storageTextureBindings ? "\n" + storageTextureBindings : ""}
+
+${options.compute}
+`;
+}
+//#endregion
+export { COMPUTE_ENTRY_CONTRACT, assertComputeContract, buildComputeShaderSource, buildComputeStorageBufferBindings, buildComputeStorageTextureBindings, buildPingPongComputeShaderSource, extractWorkgroupSize, storageTextureSampleScalarType };
+
+//# sourceMappingURL=compute-shader.js.map

package/dist/core/compute-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-shader.js","names":[],"sources":["../../src/lib/core/compute-shader.ts"],"sourcesContent":["import type { StorageBufferAccess, StorageBufferType, UniformLayout } from './types.js';\n\n/**\n * Regex contract for compute entrypoint.\n * Matches: @compute @workgroup_size(...) fn compute(\n * with @builtin(global_invocation_id) parameter.\n */\nexport const COMPUTE_ENTRY_CONTRACT = /@compute\\s+@workgroup_size\\s*\\([^)]+\\)\\s*fn\\s+compute\\s*\\(/;\n\n/**\n * Regex to extract @workgroup_size values.\n */\nconst WORKGROUP_SIZE_PATTERN =\n\t/@workgroup_size\\s*\\(\\s*(\\d+)(?:\\s*,\\s*(\\d+))?(?:\\s*,\\s*(\\d+))?\\s*\\)/;\n\n/**\n * Regex to verify @builtin(global_invocation_id) parameter.\n */\nconst GLOBAL_INVOCATION_ID_PATTERN = /@builtin\\s*\\(\\s*global_invocation_id\\s*\\)/;\nconst WORKGROUP_DIMENSION_MIN = 1;\nconst WORKGROUP_DIMENSION_MAX = 65535;\n\nfunction extractComputeParamList(compute: string): string | null {\n\tconst computeFnIndex = compute.indexOf('fn compute');\n\tif (computeFnIndex === -1) {\n\t\treturn null;\n\t}\n\n\tconst openParenIndex = compute.indexOf('(', computeFnIndex);\n\tif (openParenIndex === -1) {\n\t\treturn null;\n\t}\n\n\tlet depth = 0;\n\tfor (let index = openParenIndex; index < compute.length; index += 1) {\n\t\tconst char = compute[index];\n\t\tif (char === '(') {\n\t\t\tdepth += 1;\n\t\t\tcontinue;\n\t\t}\n\n\t\tif (char === ')') {\n\t\t\tdepth -= 1;\n\t\t\tif (depth === 0) {\n\t\t\t\treturn compute.slice(openParenIndex + 1, index);\n\t\t\t}\n\t\t}\n\t}\n\n\treturn null;\n}\n\nfunction assertWorkgroupDimension(value: number): void {\n\tif (\n\t\t!Number.isFinite(value) ||\n\t\t!Number.isInteger(value) ||\n\t\tvalue < WORKGROUP_DIMENSION_MIN ||\n\t\tvalue > WORKGROUP_DIMENSION_MAX\n\t) {\n\t\tthrow new Error(\n\t\t\t`@workgroup_size dimensions must be integers in range ${WORKGROUP_DIMENSION_MIN}-${WORKGROUP_DIMENSION_MAX}, got ${value}.`\n\t\t);\n\t}\n}\n\n/**\n * Default uniform field used when no custom uniforms are provided in compute.\n */\nconst DEFAULT_UNIFORM_FIELD = 'motiongpu_unused: vec4f,';\n\n/**\n * Validates compute shader user code matches the compute contract.\n *\n * @param compute - User compute shader WGSL source.\n * @throws {Error} When shader does not match the compute contract.\n */\nexport function assertComputeContract(compute: string): void {\n\tif (!COMPUTE_ENTRY_CONTRACT.test(compute)) {\n\t\tthrow new Error(\n\t\t\t'Compute shader must declare `@compute @workgroup_size(...) fn compute(...)`. ' +\n\t\t\t\t'Ensure the function is named `compute` and includes @compute and @workgroup_size annotations.'\n\t\t);\n\t}\n\n\tconst params = extractComputeParamList(compute);\n\tif (!params || !GLOBAL_INVOCATION_ID_PATTERN.test(params)) {\n\t\tthrow new Error('Compute shader must include a `@builtin(global_invocation_id)` parameter.');\n\t}\n\n\textractWorkgroupSize(compute);\n}\n\n/**\n * Extracts @workgroup_size values from WGSL compute shader.\n *\n * @param compute - Validated compute shader source.\n * @returns Tuple [x, y, z] with defaults of 1 for omitted dimensions.\n */\nexport function extractWorkgroupSize(compute: string): [number, number, number] {\n\tconst match = compute.match(WORKGROUP_SIZE_PATTERN);\n\tif (!match) {\n\t\tthrow new Error('Could not extract @workgroup_size from compute shader source.');\n\t}\n\n\tconst x = Number.parseInt(match[1] ?? '1', 10);\n\tconst y = Number.parseInt(match[2] ?? '1', 10);\n\tconst z = Number.parseInt(match[3] ?? '1', 10);\n\tassertWorkgroupDimension(x);\n\tassertWorkgroupDimension(y);\n\tassertWorkgroupDimension(z);\n\n\treturn [x, y, z];\n}\n\n/**\n * Maps StorageBufferAccess to WGSL var qualifier.\n */\nfunction toWgslAccessMode(access: StorageBufferAccess): string {\n\tswitch (access) {\n\t\tcase 'read':\n\t\t\treturn 'read';\n\t\tcase 'read-write':\n\t\t\treturn 'read_write';\n\t\tdefault:\n\t\t\tthrow new Error(`Unsupported storage buffer access mode \"${String(access)}\".`);\n\t}\n}\n\n/**\n * Builds WGSL struct fields for uniforms used in compute shader preamble.\n */\nfunction buildUniformStructForCompute(layout: UniformLayout): string {\n\tif (layout.entries.length === 0) {\n\t\treturn DEFAULT_UNIFORM_FIELD;\n\t}\n\n\treturn layout.entries.map((entry) => `${entry.name}: ${entry.type},`).join('\\n\\t');\n}\n\n/**\n * Builds storage buffer binding declarations for compute shader.\n *\n * @param storageBufferKeys - Sorted buffer keys.\n * @param definitions - Type/access definitions per key.\n * @param groupIndex - Bind group index for storage buffers.\n * @returns WGSL binding declaration string.\n */\nexport function buildComputeStorageBufferBindings(\n\tstorageBufferKeys: string[],\n\tdefinitions: Record<string, { type: StorageBufferType; access: StorageBufferAccess }>,\n\tgroupIndex: number\n): string {\n\tif (storageBufferKeys.length === 0) {\n\t\treturn '';\n\t}\n\n\tconst declarations: string[] = [];\n\n\tfor (let index = 0; index < storageBufferKeys.length; index += 1) {\n\t\tconst key = storageBufferKeys[index];\n\t\tif (key === undefined) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst definition = definitions[key];\n\t\tif (!definition) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst accessMode = toWgslAccessMode(definition.access);\n\t\tdeclarations.push(\n\t\t\t`@group(${groupIndex}) @binding(${index}) var<storage, ${accessMode}> ${key}: ${definition.type};`\n\t\t);\n\t}\n\n\treturn declarations.join('\\n');\n}\n\n/**\n * Builds storage texture binding declarations for compute shader.\n *\n * @param storageTextureKeys - Sorted storage texture keys.\n * @param definitions - Format definitions per key.\n * @param groupIndex - Bind group index for storage textures.\n * @returns WGSL binding declaration string.\n */\nexport function buildComputeStorageTextureBindings(\n\tstorageTextureKeys: string[],\n\tdefinitions: Record<string, { format: GPUTextureFormat }>,\n\tgroupIndex: number\n): string {\n\tif (storageTextureKeys.length === 0) {\n\t\treturn '';\n\t}\n\n\tconst declarations: string[] = [];\n\n\tfor (let index = 0; index < storageTextureKeys.length; index += 1) {\n\t\tconst key = storageTextureKeys[index];\n\t\tif (key === undefined) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst definition = definitions[key];\n\t\tif (!definition) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tdeclarations.push(\n\t\t\t`@group(${groupIndex}) @binding(${index}) var ${key}: texture_storage_2d<${definition.format}, write>;`\n\t\t);\n\t}\n\n\treturn declarations.join('\\n');\n}\n\n/**\n * Maps storage texture format to sampled texture scalar type for `texture_2d<T>`.\n */\nexport function storageTextureSampleScalarType(format: GPUTextureFormat): 'f32' | 'u32' | 'i32' {\n\tconst normalized = String(format).toLowerCase();\n\tif (normalized.endsWith('uint')) {\n\t\treturn 'u32';\n\t}\n\tif (normalized.endsWith('sint')) {\n\t\treturn 'i32';\n\t}\n\treturn 'f32';\n}\n\n/**\n * Assembles compute shader WGSL for ping-pong workflows.\n *\n * Exposes two generated bindings under group(2):\n * - `${target}A`: sampled read texture (`texture_2d<T>`)\n * - `${target}B`: storage write texture (`texture_storage_2d<format, write>`)\n */\nexport function buildPingPongComputeShaderSource(options: {\n\tcompute: string;\n\tuniformLayout: UniformLayout;\n\tstorageBufferKeys: string[];\n\tstorageBufferDefinitions: Record<\n\t\tstring,\n\t\t{ type: StorageBufferType; access: StorageBufferAccess }\n\t>;\n\ttarget: string;\n\ttargetFormat: GPUTextureFormat;\n}): string {\n\tconst uniformFields = buildUniformStructForCompute(options.uniformLayout);\n\tconst storageBufferBindings = buildComputeStorageBufferBindings(\n\t\toptions.storageBufferKeys,\n\t\toptions.storageBufferDefinitions,\n\t\t1\n\t);\n\tconst sampledType = storageTextureSampleScalarType(options.targetFormat);\n\tconst pingPongTextureBindings = [\n\t\t`@group(2) @binding(0) var ${options.target}A: texture_2d<${sampledType}>;`,\n\t\t`@group(2) @binding(1) var ${options.target}B: texture_storage_2d<${options.targetFormat}, write>;`\n\t].join('\\n');\n\n\treturn `struct MotionGPUFrame {\n\ttime: f32,\n\tdelta: f32,\n\tresolution: vec2f,\n};\n\nstruct MotionGPUUniforms {\n\t${uniformFields}\n};\n\n@group(0) @binding(0) var<uniform> motiongpuFrame: MotionGPUFrame;\n@group(0) @binding(1) var<uniform> motiongpuUniforms: MotionGPUUniforms;\n${storageBufferBindings ? '\\n' + storageBufferBindings : ''}\n${pingPongTextureBindings ? '\\n' + pingPongTextureBindings : ''}\n\n${options.compute}\n`;\n}\n\n/**\n * Assembles full compute shader WGSL with preamble.\n *\n * @param options - Compute shader build options.\n * @returns Complete WGSL source for compute stage.\n */\nexport function buildComputeShaderSource(options: {\n\tcompute: string;\n\tuniformLayout: UniformLayout;\n\tstorageBufferKeys: string[];\n\tstorageBufferDefinitions: Record<\n\t\tstring,\n\t\t{ type: StorageBufferType; access: StorageBufferAccess }\n\t>;\n\tstorageTextureKeys: string[];\n\tstorageTextureDefinitions: Record<string, { format: GPUTextureFormat }>;\n}): string {\n\tconst uniformFields = buildUniformStructForCompute(options.uniformLayout);\n\tconst storageBufferBindings = buildComputeStorageBufferBindings(\n\t\toptions.storageBufferKeys,\n\t\toptions.storageBufferDefinitions,\n\t\t1\n\t);\n\tconst storageTextureBindings = buildComputeStorageTextureBindings(\n\t\toptions.storageTextureKeys,\n\t\toptions.storageTextureDefinitions,\n\t\t2\n\t);\n\n\treturn `struct MotionGPUFrame {\n\ttime: f32,\n\tdelta: f32,\n\tresolution: vec2f,\n};\n\nstruct MotionGPUUniforms {\n\t${uniformFields}\n};\n\n@group(0) @binding(0) var<uniform> motiongpuFrame: MotionGPUFrame;\n@group(0) @binding(1) var<uniform> motiongpuUniforms: MotionGPUUniforms;\n${storageBufferBindings ? '\\n' + storageBufferBindings : ''}\n${storageTextureBindings ? '\\n' + storageTextureBindings : ''}\n\n${options.compute}\n`;\n}\n"],"mappings":"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"}

package/dist/core/current-value.d.ts

@@ -21,3 +21,4 @@ export interface CurrentWritable<T> extends CurrentReadable<T> {
  * Creates a writable value with immediate subscription semantics.
  */
 export declare function createCurrentWritable<T>(initialValue: T, onChange?: (value: T) => void): CurrentWritable<T>;
+//# sourceMappingURL=current-value.d.ts.map

package/dist/core/current-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-value.d.ts","sourceRoot":"","sources":["../../src/lib/core/current-value.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IAC7D,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IACxB,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACtC,YAAY,EAAE,CAAC,EACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAC3B,eAAe,CAAC,CAAC,CAAC,CAmCpB"}

package/dist/core/current-value.js

@@ -1,36 +1,37 @@
+//#region src/lib/core/current-value.ts
 /**
- * Creates a writable value with immediate subscription semantics.
- */
-export function createCurrentWritable(initialValue, onChange) {
-    let current = initialValue;
-    const subscribers = new Set();
-    const notify = (value) => {
-        for (const run of subscribers) {
-            run(value);
-        }
-    };
-    const set = (value) => {
-        if (Object.is(current, value)) {
-            return;
-        }
-        current = value;
-        notify(value);
-        onChange?.(value);
-    };
-    return {
-        get current() {
-            return current;
-        },
-        subscribe(run) {
-            subscribers.add(run);
-            run(current);
-            return () => {
-                subscribers.delete(run);
-            };
-        },
-        set,
-        update(updater) {
-            set(updater(current));
-        }
-    };
+* Creates a writable value with immediate subscription semantics.
+*/
+function createCurrentWritable(initialValue, onChange) {
+	let current = initialValue;
+	const subscribers = /* @__PURE__ */ new Set();
+	const notify = (value) => {
+		for (const run of subscribers) run(value);
+	};
+	const set = (value) => {
+		if (Object.is(current, value)) return;
+		current = value;
+		notify(value);
+		onChange?.(value);
+	};
+	return {
+		get current() {
+			return current;
+		},
+		subscribe(run) {
+			subscribers.add(run);
+			run(current);
+			return () => {
+				subscribers.delete(run);
+			};
+		},
+		set,
+		update(updater) {
+			set(updater(current));
+		}
+	};
 }
+//#endregion
+export { createCurrentWritable };
+
+//# sourceMappingURL=current-value.js.map

package/dist/core/current-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-value.js","names":[],"sources":["../../src/lib/core/current-value.ts"],"sourcesContent":["/**\n * Minimal subscribe contract used by MotionGPU core.\n */\nexport interface Subscribable<T> {\n\tsubscribe: (run: (value: T) => void) => () => void;\n}\n\n/**\n * Readable value with synchronous access to the latest value.\n */\nexport interface CurrentReadable<T> extends Subscribable<T> {\n\treadonly current: T;\n}\n\n/**\n * Writable extension of {@link CurrentReadable}.\n */\nexport interface CurrentWritable<T> extends CurrentReadable<T> {\n\tset: (value: T) => void;\n\tupdate: (updater: (value: T) => T) => void;\n}\n\n/**\n * Creates a writable value with immediate subscription semantics.\n */\nexport function createCurrentWritable<T>(\n\tinitialValue: T,\n\tonChange?: (value: T) => void\n): CurrentWritable<T> {\n\tlet current = initialValue;\n\tconst subscribers = new Set<(value: T) => void>();\n\n\tconst notify = (value: T): void => {\n\t\tfor (const run of subscribers) {\n\t\t\trun(value);\n\t\t}\n\t};\n\n\tconst set = (value: T): void => {\n\t\tif (Object.is(current, value)) {\n\t\t\treturn;\n\t\t}\n\t\tcurrent = value;\n\t\tnotify(value);\n\t\tonChange?.(value);\n\t};\n\n\treturn {\n\t\tget current() {\n\t\t\treturn current;\n\t\t},\n\t\tsubscribe(run) {\n\t\t\tsubscribers.add(run);\n\t\t\trun(current);\n\t\t\treturn () => {\n\t\t\t\tsubscribers.delete(run);\n\t\t\t};\n\t\t},\n\t\tset,\n\t\tupdate(updater) {\n\t\t\tset(updater(current));\n\t\t}\n\t};\n}\n"],"mappings":";;;;AAyBA,SAAgB,sBACf,cACA,UACqB;CACrB,IAAI,UAAU;CACd,MAAM,8BAAc,IAAI,KAAyB;CAEjD,MAAM,UAAU,UAAmB;AAClC,OAAK,MAAM,OAAO,YACjB,KAAI,MAAM;;CAIZ,MAAM,OAAO,UAAmB;AAC/B,MAAI,OAAO,GAAG,SAAS,MAAM,CAC5B;AAED,YAAU;AACV,SAAO,MAAM;AACb,aAAW,MAAM;;AAGlB,QAAO;EACN,IAAI,UAAU;AACb,UAAO;;EAER,UAAU,KAAK;AACd,eAAY,IAAI,IAAI;AACpB,OAAI,QAAQ;AACZ,gBAAa;AACZ,gBAAY,OAAO,IAAI;;;EAGzB;EACA,OAAO,SAAS;AACf,OAAI,QAAQ,QAAQ,CAAC;;EAEtB"}

package/dist/core/error-diagnostics.d.ts

@@ -52,3 +52,4 @@ export declare function attachShaderCompilationDiagnostics(error: Error, payload
  * Extracts structured diagnostics payload from unknown error value.
  */
 export declare function getShaderCompilationDiagnostics(error: unknown): ShaderCompilationDiagnosticsPayload | null;
+//# sourceMappingURL=error-diagnostics.d.ts.map

package/dist/core/error-diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/core/error-diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC/C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IACF,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IACnD,IAAI,EAAE,oBAAoB,CAAC;IAC3B,WAAW,EAAE,2BAA2B,EAAE,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,cAAc,CAAC,EAAE,+BAA+B,CAAC;CACjD;AAkHD;;GAEG;AACH,wBAAgB,kCAAkC,CACjD,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,mCAAmC,GAC1C,KAAK,CAGP;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC9C,KAAK,EAAE,OAAO,GACZ,mCAAmC,GAAG,IAAI,CAwD5C"}