@motion-core/motion-gpu 0.5.0 → 0.7.0

package/README.md

@@ -65,7 +65,7 @@ Motion GPU follows a simple three-step flow:
 
 1. Define an immutable material with `defineMaterial(...)`.
 2. Render it with `<FragCanvas />`.
-3. Drive runtime updates with `useFrame(...)`, `useMotionGPU()`, and `useTexture(...)`.
+3. Drive runtime updates with `useFrame(...)`, `useMotionGPU()`, `usePointer()`, and `useTexture(...)`.
 
 ---
 
@@ -100,6 +100,7 @@ Motion GPU follows a simple three-step flow:
 - `defineMaterial`
 - `useMotionGPU`
 - `useFrame`
+- `usePointer`
 - `useTexture`
 - `ShaderPass`
 - `BlitPass`
@@ -134,6 +135,7 @@ Also exports runtime/core types:
 - `defineMaterial`
 - `useMotionGPU`
 - `useFrame`
+- `usePointer`
 - `useTexture`
 - `ShaderPass`
 - `BlitPass`
@@ -308,6 +310,37 @@ export function Runtime() {
 
 ---
 
+## 2b. Add pointer-driven uniforms via `usePointer`
+
+```svelte
+<!-- Runtime.svelte -->
+<script lang="ts">
+	import { useFrame, usePointer } from '@motion-core/motion-gpu/svelte';
+
+	const pointer = usePointer();
+
+	useFrame((state) => {
+		state.setUniform('uMouse', pointer.state.current.uv);
+	});
+</script>
+```
+
+```tsx
+import { useFrame, usePointer } from '@motion-core/motion-gpu/react';
+
+export function Runtime() {
+	const pointer = usePointer();
+
+	useFrame((state) => {
+		state.setUniform('uMouse', pointer.state.current.uv);
+	});
+
+	return null;
+}
+```
+
+---
+
 ## 3. Add a GPU compute pass
 
 ```svelte
@@ -442,7 +475,7 @@ fn frag(uv: vec2f) -> vec4f
 fn shade(inputColor: vec4f, uv: vec2f) -> vec4f
 ```
 
-3. `useFrame()` and `useMotionGPU()` must be called inside `<FragCanvas>` subtree.
+3. `useFrame()`, `useMotionGPU()`, and `usePointer()` must be called inside `<FragCanvas>` subtree.
 
 4. You can only set uniforms/textures that were declared in `defineMaterial(...)`.
 

package/dist/core/compute-bindgroup-cache.d.ts

@@ -0,0 +1,13 @@
+/// <reference types="@webgpu/types" />
+export interface ComputeStorageBindGroupCacheRequest {
+    topologyKey: string;
+    layoutEntries: GPUBindGroupLayoutEntry[];
+    bindGroupEntries: GPUBindGroupEntry[];
+    resourceRefs: readonly unknown[];
+}
+export interface ComputeStorageBindGroupCache {
+    getOrCreate: (request: ComputeStorageBindGroupCacheRequest) => GPUBindGroup | null;
+    reset: () => void;
+}
+export declare function createComputeStorageBindGroupCache(device: GPUDevice): ComputeStorageBindGroupCache;
+//# sourceMappingURL=compute-bindgroup-cache.d.ts.map

package/dist/core/compute-bindgroup-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-bindgroup-cache.d.ts","sourceRoot":"","sources":["../../src/lib/core/compute-bindgroup-cache.ts"],"names":[],"mappings":";AAAA,MAAM,WAAW,mCAAmC;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,uBAAuB,EAAE,CAAC;IACzC,gBAAgB,EAAE,iBAAiB,EAAE,CAAC;IACtC,YAAY,EAAE,SAAS,OAAO,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,4BAA4B;IAC5C,WAAW,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,YAAY,GAAG,IAAI,CAAC;IACnF,KAAK,EAAE,MAAM,IAAI,CAAC;CAClB;AAgBD,wBAAgB,kCAAkC,CACjD,MAAM,EAAE,SAAS,GACf,4BAA4B,CA4C9B"}

package/dist/core/compute-bindgroup-cache.js

@@ -0,0 +1,45 @@
+//#region src/lib/core/compute-bindgroup-cache.ts
+function equalResourceRefs(previous, next) {
+	if (previous.length !== next.length) return false;
+	for (let index = 0; index < previous.length; index += 1) if (!Object.is(previous[index], next[index])) return false;
+	return true;
+}
+function createComputeStorageBindGroupCache(device) {
+	let cachedTopologyKey = null;
+	let cachedLayout = null;
+	let cachedBindGroup = null;
+	let cachedResourceRefs = [];
+	const reset = () => {
+		cachedTopologyKey = null;
+		cachedLayout = null;
+		cachedBindGroup = null;
+		cachedResourceRefs = [];
+	};
+	return {
+		getOrCreate(request) {
+			if (request.layoutEntries.length === 0) {
+				reset();
+				return null;
+			}
+			if (cachedTopologyKey !== request.topologyKey) {
+				cachedTopologyKey = request.topologyKey;
+				cachedLayout = device.createBindGroupLayout({ entries: request.layoutEntries });
+				cachedBindGroup = null;
+				cachedResourceRefs = [];
+			}
+			if (!cachedLayout) throw new Error("Compute storage bind group cache is missing a layout.");
+			if (cachedBindGroup && equalResourceRefs(cachedResourceRefs, request.resourceRefs)) return cachedBindGroup;
+			cachedBindGroup = device.createBindGroup({
+				layout: cachedLayout,
+				entries: request.bindGroupEntries
+			});
+			cachedResourceRefs = [...request.resourceRefs];
+			return cachedBindGroup;
+		},
+		reset
+	};
+}
+//#endregion
+export { createComputeStorageBindGroupCache };
+
+//# sourceMappingURL=compute-bindgroup-cache.js.map

package/dist/core/compute-bindgroup-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-bindgroup-cache.js","names":[],"sources":["../../src/lib/core/compute-bindgroup-cache.ts"],"sourcesContent":["export interface ComputeStorageBindGroupCacheRequest {\n\ttopologyKey: string;\n\tlayoutEntries: GPUBindGroupLayoutEntry[];\n\tbindGroupEntries: GPUBindGroupEntry[];\n\tresourceRefs: readonly unknown[];\n}\n\nexport interface ComputeStorageBindGroupCache {\n\tgetOrCreate: (request: ComputeStorageBindGroupCacheRequest) => GPUBindGroup | null;\n\treset: () => void;\n}\n\nfunction equalResourceRefs(previous: readonly unknown[], next: readonly unknown[]): boolean {\n\tif (previous.length !== next.length) {\n\t\treturn false;\n\t}\n\n\tfor (let index = 0; index < previous.length; index += 1) {\n\t\tif (!Object.is(previous[index], next[index])) {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\treturn true;\n}\n\nexport function createComputeStorageBindGroupCache(\n\tdevice: GPUDevice\n): ComputeStorageBindGroupCache {\n\tlet cachedTopologyKey: string | null = null;\n\tlet cachedLayout: GPUBindGroupLayout | null = null;\n\tlet cachedBindGroup: GPUBindGroup | null = null;\n\tlet cachedResourceRefs: readonly unknown[] = [];\n\n\tconst reset = (): void => {\n\t\tcachedTopologyKey = null;\n\t\tcachedLayout = null;\n\t\tcachedBindGroup = null;\n\t\tcachedResourceRefs = [];\n\t};\n\n\treturn {\n\t\tgetOrCreate(request) {\n\t\t\tif (request.layoutEntries.length === 0) {\n\t\t\t\treset();\n\t\t\t\treturn null;\n\t\t\t}\n\n\t\t\tif (cachedTopologyKey !== request.topologyKey) {\n\t\t\t\tcachedTopologyKey = request.topologyKey;\n\t\t\t\tcachedLayout = device.createBindGroupLayout({ entries: request.layoutEntries });\n\t\t\t\tcachedBindGroup = null;\n\t\t\t\tcachedResourceRefs = [];\n\t\t\t}\n\n\t\t\tif (!cachedLayout) {\n\t\t\t\tthrow new Error('Compute storage bind group cache is missing a layout.');\n\t\t\t}\n\n\t\t\tif (cachedBindGroup && equalResourceRefs(cachedResourceRefs, request.resourceRefs)) {\n\t\t\t\treturn cachedBindGroup;\n\t\t\t}\n\n\t\t\tcachedBindGroup = device.createBindGroup({\n\t\t\t\tlayout: cachedLayout,\n\t\t\t\tentries: request.bindGroupEntries\n\t\t\t});\n\t\t\tcachedResourceRefs = [...request.resourceRefs];\n\t\t\treturn cachedBindGroup;\n\t\t},\n\t\treset\n\t};\n}\n"],"mappings":";AAYA,SAAS,kBAAkB,UAA8B,MAAmC;AAC3F,KAAI,SAAS,WAAW,KAAK,OAC5B,QAAO;AAGR,MAAK,IAAI,QAAQ,GAAG,QAAQ,SAAS,QAAQ,SAAS,EACrD,KAAI,CAAC,OAAO,GAAG,SAAS,QAAQ,KAAK,OAAO,CAC3C,QAAO;AAIT,QAAO;;AAGR,SAAgB,mCACf,QAC+B;CAC/B,IAAI,oBAAmC;CACvC,IAAI,eAA0C;CAC9C,IAAI,kBAAuC;CAC3C,IAAI,qBAAyC,EAAE;CAE/C,MAAM,cAAoB;AACzB,sBAAoB;AACpB,iBAAe;AACf,oBAAkB;AAClB,uBAAqB,EAAE;;AAGxB,QAAO;EACN,YAAY,SAAS;AACpB,OAAI,QAAQ,cAAc,WAAW,GAAG;AACvC,WAAO;AACP,WAAO;;AAGR,OAAI,sBAAsB,QAAQ,aAAa;AAC9C,wBAAoB,QAAQ;AAC5B,mBAAe,OAAO,sBAAsB,EAAE,SAAS,QAAQ,eAAe,CAAC;AAC/E,sBAAkB;AAClB,yBAAqB,EAAE;;AAGxB,OAAI,CAAC,aACJ,OAAM,IAAI,MAAM,wDAAwD;AAGzE,OAAI,mBAAmB,kBAAkB,oBAAoB,QAAQ,aAAa,CACjF,QAAO;AAGR,qBAAkB,OAAO,gBAAgB;IACxC,QAAQ;IACR,SAAS,QAAQ;IACjB,CAAC;AACF,wBAAqB,CAAC,GAAG,QAAQ,aAAa;AAC9C,UAAO;;EAER;EACA"}

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

@@ -65,6 +65,24 @@ export declare function buildPingPongComputeShaderSource(options: {
     target: string;
     targetFormat: GPUTextureFormat;
 }): string;
+/**
+ * Source location for generated compute shader lines.
+ */
+export interface ComputeShaderSourceLocation {
+    kind: 'compute';
+    line: number;
+}
+/**
+ * 1-based line map from generated compute WGSL to user compute source.
+ */
+export type ComputeShaderLineMap = Array<ComputeShaderSourceLocation | null>;
+/**
+ * Result of compute shader source generation with line mapping metadata.
+ */
+export interface BuiltComputeShaderSource {
+    code: string;
+    lineMap: ComputeShaderLineMap;
+}
 /**
  * Assembles full compute shader WGSL with preamble.
  *
@@ -84,4 +102,34 @@ export declare function buildComputeShaderSource(options: {
         format: GPUTextureFormat;
     }>;
 }): string;
+/**
+ * Assembles full compute shader WGSL with source line mapping metadata.
+ */
+export declare function buildComputeShaderSourceWithMap(options: {
+    compute: string;
+    uniformLayout: UniformLayout;
+    storageBufferKeys: string[];
+    storageBufferDefinitions: Record<string, {
+        type: StorageBufferType;
+        access: StorageBufferAccess;
+    }>;
+    storageTextureKeys: string[];
+    storageTextureDefinitions: Record<string, {
+        format: GPUTextureFormat;
+    }>;
+}): BuiltComputeShaderSource;
+/**
+ * Assembles ping-pong compute shader WGSL with source line mapping metadata.
+ */
+export declare function buildPingPongComputeShaderSourceWithMap(options: {
+    compute: string;
+    uniformLayout: UniformLayout;
+    storageBufferKeys: string[];
+    storageBufferDefinitions: Record<string, {
+        type: StorageBufferType;
+        access: StorageBufferAccess;
+    }>;
+    target: string;
+    targetFormat: GPUTextureFormat;
+}): BuiltComputeShaderSource;
 //# sourceMappingURL=compute-shader.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"compute-shader.d.ts","sourceRoot":"","sources":["../../src/lib/core/compute-shader.ts"],"names":[],"mappings":"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"}

package/dist/core/compute-shader.js

@@ -199,7 +199,40 @@ ${storageTextureBindings ? "\n" + storageTextureBindings : ""}
 ${options.compute}
 `;
 }
+function buildComputeLineMap(generatedCode, userComputeSource) {
+	const lineCount = generatedCode.split("\n").length;
+	const lineMap = new Array(lineCount + 1).fill(null);
+	const computeStartIndex = generatedCode.indexOf(userComputeSource);
+	if (computeStartIndex === -1) return lineMap;
+	const computeStartLine = generatedCode.slice(0, computeStartIndex).split("\n").length;
+	const computeLineCount = userComputeSource.split("\n").length;
+	for (let line = 0; line < computeLineCount; line += 1) lineMap[computeStartLine + line] = {
+		kind: "compute",
+		line: line + 1
+	};
+	return lineMap;
+}
+/**
+* Assembles full compute shader WGSL with source line mapping metadata.
+*/
+function buildComputeShaderSourceWithMap(options) {
+	const code = buildComputeShaderSource(options);
+	return {
+		code,
+		lineMap: buildComputeLineMap(code, options.compute)
+	};
+}
+/**
+* Assembles ping-pong compute shader WGSL with source line mapping metadata.
+*/
+function buildPingPongComputeShaderSourceWithMap(options) {
+	const code = buildPingPongComputeShaderSource(options);
+	return {
+		code,
+		lineMap: buildComputeLineMap(code, options.compute)
+	};
+}
 //#endregion
-export { COMPUTE_ENTRY_CONTRACT, assertComputeContract, buildComputeShaderSource, buildComputeStorageBufferBindings, buildComputeStorageTextureBindings, buildPingPongComputeShaderSource, extractWorkgroupSize, storageTextureSampleScalarType };
+export { COMPUTE_ENTRY_CONTRACT, assertComputeContract, buildComputeShaderSource, buildComputeShaderSourceWithMap, buildComputeStorageBufferBindings, buildComputeStorageTextureBindings, buildPingPongComputeShaderSource, buildPingPongComputeShaderSourceWithMap, extractWorkgroupSize, storageTextureSampleScalarType };
 
 //# sourceMappingURL=compute-shader.js.map

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

@@ -1 +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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"}
+{"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 * Source location for generated compute shader lines.\n */\nexport interface ComputeShaderSourceLocation {\n\tkind: 'compute';\n\tline: number;\n}\n\n/**\n * 1-based line map from generated compute WGSL to user compute source.\n */\nexport type ComputeShaderLineMap = Array<ComputeShaderSourceLocation | null>;\n\n/**\n * Result of compute shader source generation with line mapping metadata.\n */\nexport interface BuiltComputeShaderSource {\n\tcode: string;\n\tlineMap: ComputeShaderLineMap;\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\nfunction buildComputeLineMap(\n\tgeneratedCode: string,\n\tuserComputeSource: string\n): ComputeShaderLineMap {\n\tconst lineCount = generatedCode.split('\\n').length;\n\tconst lineMap: ComputeShaderLineMap = new Array(lineCount + 1).fill(null);\n\tconst computeStartIndex = generatedCode.indexOf(userComputeSource);\n\tif (computeStartIndex === -1) {\n\t\treturn lineMap;\n\t}\n\n\tconst computeStartLine = generatedCode.slice(0, computeStartIndex).split('\\n').length;\n\tconst computeLineCount = userComputeSource.split('\\n').length;\n\tfor (let line = 0; line < computeLineCount; line += 1) {\n\t\tlineMap[computeStartLine + line] = {\n\t\t\tkind: 'compute',\n\t\t\tline: line + 1\n\t\t};\n\t}\n\n\treturn lineMap;\n}\n\n/**\n * Assembles full compute shader WGSL with source line mapping metadata.\n */\nexport function buildComputeShaderSourceWithMap(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}): BuiltComputeShaderSource {\n\tconst code = buildComputeShaderSource(options);\n\treturn {\n\t\tcode,\n\t\tlineMap: buildComputeLineMap(code, options.compute)\n\t};\n}\n\n/**\n * Assembles ping-pong compute shader WGSL with source line mapping metadata.\n */\nexport function buildPingPongComputeShaderSourceWithMap(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}): BuiltComputeShaderSource {\n\tconst code = buildPingPongComputeShaderSource(options);\n\treturn {\n\t\tcode,\n\t\tlineMap: buildComputeLineMap(code, options.compute)\n\t};\n}\n"],"mappings":"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"}

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

@@ -9,6 +9,11 @@ export interface MaterialSourceMetadata {
     column?: number;
     functionName?: string;
 }
+export interface ComputeSourceLocation {
+    kind: 'compute';
+    line: number;
+}
+export type ShaderSourceLocation = MaterialSourceLocation | ComputeSourceLocation;
 /**
  * One WGSL compiler diagnostic enriched with source-location metadata.
  */
@@ -17,7 +22,7 @@ export interface ShaderCompilationDiagnostic {
     message: string;
     linePos?: number;
     lineLength?: number;
-    sourceLocation: MaterialSourceLocation | null;
+    sourceLocation: ShaderSourceLocation | null;
 }
 /**
  * Runtime context snapshot captured for shader compilation diagnostics.
@@ -37,8 +42,10 @@ export interface ShaderCompilationRuntimeContext {
  */
 export interface ShaderCompilationDiagnosticsPayload {
     kind: 'shader-compilation';
+    shaderStage?: 'fragment' | 'compute';
     diagnostics: ShaderCompilationDiagnostic[];
     fragmentSource: string;
+    computeSource?: string;
     includeSources: Record<string, string>;
     defineBlockSource?: string;
     materialSource: MaterialSourceMetadata | null;

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

@@ -1 +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"}
+{"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,MAAM,WAAW,qBAAqB;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAElF;;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,oBAAoB,GAAG,IAAI,CAAC;CAC5C;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,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACrC,WAAW,EAAE,2BAA2B,EAAE,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,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,CAwE5C"}

package/dist/core/error-diagnostics.js

@@ -9,12 +9,12 @@ function isMaterialSourceMetadata(value) {
 	if (record.column !== void 0 && typeof record.column !== "number") return false;
 	return true;
 }
-function isMaterialSourceLocation(value) {
+function isShaderSourceLocation(value) {
 	if (value === null) return true;
 	if (typeof value !== "object") return false;
 	const record = value;
 	const kind = record.kind;
-	if (kind !== "fragment" && kind !== "include" && kind !== "define") return false;
+	if (kind !== "fragment" && kind !== "include" && kind !== "define" && kind !== "compute") return false;
 	return typeof record.line === "number";
 }
 function isShaderCompilationDiagnostic(value) {
@@ -24,7 +24,7 @@ function isShaderCompilationDiagnostic(value) {
 	if (typeof record.message !== "string") return false;
 	if (record.linePos !== void 0 && typeof record.linePos !== "number") return false;
 	if (record.lineLength !== void 0 && typeof record.lineLength !== "number") return false;
-	if (!isMaterialSourceLocation(record.sourceLocation)) return false;
+	if (!isShaderSourceLocation(record.sourceLocation)) return false;
 	return true;
 }
 function isStringArray(value) {
@@ -60,8 +60,10 @@ function getShaderCompilationDiagnostics(error) {
 	if (payload === null || typeof payload !== "object") return null;
 	const record = payload;
 	if (record.kind !== "shader-compilation") return null;
+	if (record.shaderStage !== void 0 && record.shaderStage !== "fragment" && record.shaderStage !== "compute") return null;
 	if (!Array.isArray(record.diagnostics) || !record.diagnostics.every(isShaderCompilationDiagnostic)) return null;
 	if (typeof record.fragmentSource !== "string") return null;
+	if (record.computeSource !== void 0 && typeof record.computeSource !== "string") return null;
 	if (record.defineBlockSource !== void 0 && typeof record.defineBlockSource !== "string") return null;
 	if (record.includeSources === null || typeof record.includeSources !== "object") return null;
 	const includeSources = record.includeSources;
@@ -70,8 +72,10 @@ function getShaderCompilationDiagnostics(error) {
 	if (record.runtimeContext !== void 0 && !isShaderCompilationRuntimeContext(record.runtimeContext)) return null;
 	return {
 		kind: "shader-compilation",
+		...record.shaderStage !== void 0 ? { shaderStage: record.shaderStage } : {},
 		diagnostics: record.diagnostics,
 		fragmentSource: record.fragmentSource,
+		...record.computeSource !== void 0 ? { computeSource: record.computeSource } : {},
 		includeSources,
 		...record.defineBlockSource !== void 0 ? { defineBlockSource: record.defineBlockSource } : {},
 		materialSource: record.materialSource ?? null,

package/dist/core/error-diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-diagnostics.js","names":[],"sources":["../../src/lib/core/error-diagnostics.ts"],"sourcesContent":["import type { MaterialSourceLocation } from './material-preprocess.js';\n\n/**\n * Source metadata for material declaration callsite.\n */\nexport interface MaterialSourceMetadata {\n\tcomponent?: string;\n\tfile?: string;\n\tline?: number;\n\tcolumn?: number;\n\tfunctionName?: string;\n}\n\n/**\n * One WGSL compiler diagnostic enriched with source-location metadata.\n */\nexport interface ShaderCompilationDiagnostic {\n\tgeneratedLine: number;\n\tmessage: string;\n\tlinePos?: number;\n\tlineLength?: number;\n\tsourceLocation: MaterialSourceLocation | null;\n}\n\n/**\n * Runtime context snapshot captured for shader compilation diagnostics.\n */\nexport interface ShaderCompilationRuntimeContext {\n\tmaterialSignature?: string;\n\tpassGraph?: {\n\t\tpassCount: number;\n\t\tenabledPassCount: number;\n\t\tinputs: string[];\n\t\toutputs: string[];\n\t};\n\tactiveRenderTargets: string[];\n}\n\n/**\n * Structured payload attached to WGSL compilation errors.\n */\nexport interface ShaderCompilationDiagnosticsPayload {\n\tkind: 'shader-compilation';\n\tdiagnostics: ShaderCompilationDiagnostic[];\n\tfragmentSource: string;\n\tincludeSources: Record<string, string>;\n\tdefineBlockSource?: string;\n\tmaterialSource: MaterialSourceMetadata | null;\n\truntimeContext?: ShaderCompilationRuntimeContext;\n}\n\ntype MotionGPUErrorWithDiagnostics = Error & {\n\tmotiongpuDiagnostics?: unknown;\n};\n\nfunction isMaterialSourceMetadata(value: unknown): value is MaterialSourceMetadata {\n\tif (value === null || typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tif (record.component !== undefined && typeof record.component !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.file !== undefined && typeof record.file !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.functionName !== undefined && typeof record.functionName !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.line !== undefined && typeof record.line !== 'number') {\n\t\treturn false;\n\t}\n\tif (record.column !== undefined && typeof record.column !== 'number') {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\nfunction isMaterialSourceLocation(value: unknown): value is MaterialSourceLocation | null {\n\tif (value === null) {\n\t\treturn true;\n\t}\n\n\tif (typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tconst kind = record.kind;\n\tif (kind !== 'fragment' && kind !== 'include' && kind !== 'define') {\n\t\treturn false;\n\t}\n\n\treturn typeof record.line === 'number';\n}\n\nfunction isShaderCompilationDiagnostic(value: unknown): value is ShaderCompilationDiagnostic {\n\tif (value === null || typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tif (typeof record.generatedLine !== 'number') {\n\t\treturn false;\n\t}\n\tif (typeof record.message !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.linePos !== undefined && typeof record.linePos !== 'number') {\n\t\treturn false;\n\t}\n\tif (record.lineLength !== undefined && typeof record.lineLength !== 'number') {\n\t\treturn false;\n\t}\n\tif (!isMaterialSourceLocation(record.sourceLocation)) {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n\treturn Array.isArray(value) && value.every((entry) => typeof entry === 'string');\n}\n\nfunction isShaderCompilationRuntimeContext(\n\tvalue: unknown\n): value is ShaderCompilationRuntimeContext {\n\tif (value === null || typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tif (record.materialSignature !== undefined && typeof record.materialSignature !== 'string') {\n\t\treturn false;\n\t}\n\tif (!isStringArray(record.activeRenderTargets)) {\n\t\treturn false;\n\t}\n\tconst passGraph = record.passGraph;\n\tif (passGraph === undefined) {\n\t\treturn true;\n\t}\n\tif (passGraph === null || typeof passGraph !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst passGraphRecord = passGraph as Record<string, unknown>;\n\tif (typeof passGraphRecord.passCount !== 'number') {\n\t\treturn false;\n\t}\n\tif (typeof passGraphRecord.enabledPassCount !== 'number') {\n\t\treturn false;\n\t}\n\tif (!isStringArray(passGraphRecord.inputs) || !isStringArray(passGraphRecord.outputs)) {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\n/**\n * Attaches structured diagnostics payload to an Error.\n */\nexport function attachShaderCompilationDiagnostics(\n\terror: Error,\n\tpayload: ShaderCompilationDiagnosticsPayload\n): Error {\n\t(error as MotionGPUErrorWithDiagnostics).motiongpuDiagnostics = payload;\n\treturn error;\n}\n\n/**\n * Extracts structured diagnostics payload from unknown error value.\n */\nexport function getShaderCompilationDiagnostics(\n\terror: unknown\n): ShaderCompilationDiagnosticsPayload | null {\n\tif (!(error instanceof Error)) {\n\t\treturn null;\n\t}\n\n\tconst payload = (error as MotionGPUErrorWithDiagnostics).motiongpuDiagnostics;\n\tif (payload === null || typeof payload !== 'object') {\n\t\treturn null;\n\t}\n\n\tconst record = payload as Record<string, unknown>;\n\tif (record.kind !== 'shader-compilation') {\n\t\treturn null;\n\t}\n\tif (\n\t\t!Array.isArray(record.diagnostics) ||\n\t\t!record.diagnostics.every(isShaderCompilationDiagnostic)\n\t) {\n\t\treturn null;\n\t}\n\tif (typeof record.fragmentSource !== 'string') {\n\t\treturn null;\n\t}\n\tif (record.defineBlockSource !== undefined && typeof record.defineBlockSource !== 'string') {\n\t\treturn null;\n\t}\n\tif (record.includeSources === null || typeof record.includeSources !== 'object') {\n\t\treturn null;\n\t}\n\tconst includeSources = record.includeSources as Record<string, unknown>;\n\tif (Object.values(includeSources).some((value) => typeof value !== 'string')) {\n\t\treturn null;\n\t}\n\tif (record.materialSource !== null && !isMaterialSourceMetadata(record.materialSource)) {\n\t\treturn null;\n\t}\n\tif (\n\t\trecord.runtimeContext !== undefined &&\n\t\t!isShaderCompilationRuntimeContext(record.runtimeContext)\n\t) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tkind: 'shader-compilation',\n\t\tdiagnostics: record.diagnostics as ShaderCompilationDiagnostic[],\n\t\tfragmentSource: record.fragmentSource,\n\t\tincludeSources: includeSources as Record<string, string>,\n\t\t...(record.defineBlockSource !== undefined\n\t\t\t? { defineBlockSource: record.defineBlockSource as string }\n\t\t\t: {}),\n\t\tmaterialSource: (record.materialSource ?? null) as MaterialSourceMetadata | null,\n\t\t...(record.runtimeContext !== undefined\n\t\t\t? { runtimeContext: record.runtimeContext as ShaderCompilationRuntimeContext }\n\t\t\t: {})\n\t};\n}\n"],"mappings":"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"}
+{"version":3,"file":"error-diagnostics.js","names":[],"sources":["../../src/lib/core/error-diagnostics.ts"],"sourcesContent":["import type { MaterialSourceLocation } from './material-preprocess.js';\n\n/**\n * Source metadata for material declaration callsite.\n */\nexport interface MaterialSourceMetadata {\n\tcomponent?: string;\n\tfile?: string;\n\tline?: number;\n\tcolumn?: number;\n\tfunctionName?: string;\n}\n\nexport interface ComputeSourceLocation {\n\tkind: 'compute';\n\tline: number;\n}\n\nexport type ShaderSourceLocation = MaterialSourceLocation | ComputeSourceLocation;\n\n/**\n * One WGSL compiler diagnostic enriched with source-location metadata.\n */\nexport interface ShaderCompilationDiagnostic {\n\tgeneratedLine: number;\n\tmessage: string;\n\tlinePos?: number;\n\tlineLength?: number;\n\tsourceLocation: ShaderSourceLocation | null;\n}\n\n/**\n * Runtime context snapshot captured for shader compilation diagnostics.\n */\nexport interface ShaderCompilationRuntimeContext {\n\tmaterialSignature?: string;\n\tpassGraph?: {\n\t\tpassCount: number;\n\t\tenabledPassCount: number;\n\t\tinputs: string[];\n\t\toutputs: string[];\n\t};\n\tactiveRenderTargets: string[];\n}\n\n/**\n * Structured payload attached to WGSL compilation errors.\n */\nexport interface ShaderCompilationDiagnosticsPayload {\n\tkind: 'shader-compilation';\n\tshaderStage?: 'fragment' | 'compute';\n\tdiagnostics: ShaderCompilationDiagnostic[];\n\tfragmentSource: string;\n\tcomputeSource?: string;\n\tincludeSources: Record<string, string>;\n\tdefineBlockSource?: string;\n\tmaterialSource: MaterialSourceMetadata | null;\n\truntimeContext?: ShaderCompilationRuntimeContext;\n}\n\ntype MotionGPUErrorWithDiagnostics = Error & {\n\tmotiongpuDiagnostics?: unknown;\n};\n\nfunction isMaterialSourceMetadata(value: unknown): value is MaterialSourceMetadata {\n\tif (value === null || typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tif (record.component !== undefined && typeof record.component !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.file !== undefined && typeof record.file !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.functionName !== undefined && typeof record.functionName !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.line !== undefined && typeof record.line !== 'number') {\n\t\treturn false;\n\t}\n\tif (record.column !== undefined && typeof record.column !== 'number') {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\nfunction isShaderSourceLocation(value: unknown): value is ShaderSourceLocation | null {\n\tif (value === null) {\n\t\treturn true;\n\t}\n\n\tif (typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tconst kind = record.kind;\n\tif (kind !== 'fragment' && kind !== 'include' && kind !== 'define' && kind !== 'compute') {\n\t\treturn false;\n\t}\n\n\treturn typeof record.line === 'number';\n}\n\nfunction isShaderCompilationDiagnostic(value: unknown): value is ShaderCompilationDiagnostic {\n\tif (value === null || typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tif (typeof record.generatedLine !== 'number') {\n\t\treturn false;\n\t}\n\tif (typeof record.message !== 'string') {\n\t\treturn false;\n\t}\n\tif (record.linePos !== undefined && typeof record.linePos !== 'number') {\n\t\treturn false;\n\t}\n\tif (record.lineLength !== undefined && typeof record.lineLength !== 'number') {\n\t\treturn false;\n\t}\n\tif (!isShaderSourceLocation(record.sourceLocation)) {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\nfunction isStringArray(value: unknown): value is string[] {\n\treturn Array.isArray(value) && value.every((entry) => typeof entry === 'string');\n}\n\nfunction isShaderCompilationRuntimeContext(\n\tvalue: unknown\n): value is ShaderCompilationRuntimeContext {\n\tif (value === null || typeof value !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst record = value as Record<string, unknown>;\n\tif (record.materialSignature !== undefined && typeof record.materialSignature !== 'string') {\n\t\treturn false;\n\t}\n\tif (!isStringArray(record.activeRenderTargets)) {\n\t\treturn false;\n\t}\n\tconst passGraph = record.passGraph;\n\tif (passGraph === undefined) {\n\t\treturn true;\n\t}\n\tif (passGraph === null || typeof passGraph !== 'object') {\n\t\treturn false;\n\t}\n\n\tconst passGraphRecord = passGraph as Record<string, unknown>;\n\tif (typeof passGraphRecord.passCount !== 'number') {\n\t\treturn false;\n\t}\n\tif (typeof passGraphRecord.enabledPassCount !== 'number') {\n\t\treturn false;\n\t}\n\tif (!isStringArray(passGraphRecord.inputs) || !isStringArray(passGraphRecord.outputs)) {\n\t\treturn false;\n\t}\n\n\treturn true;\n}\n\n/**\n * Attaches structured diagnostics payload to an Error.\n */\nexport function attachShaderCompilationDiagnostics(\n\terror: Error,\n\tpayload: ShaderCompilationDiagnosticsPayload\n): Error {\n\t(error as MotionGPUErrorWithDiagnostics).motiongpuDiagnostics = payload;\n\treturn error;\n}\n\n/**\n * Extracts structured diagnostics payload from unknown error value.\n */\nexport function getShaderCompilationDiagnostics(\n\terror: unknown\n): ShaderCompilationDiagnosticsPayload | null {\n\tif (!(error instanceof Error)) {\n\t\treturn null;\n\t}\n\n\tconst payload = (error as MotionGPUErrorWithDiagnostics).motiongpuDiagnostics;\n\tif (payload === null || typeof payload !== 'object') {\n\t\treturn null;\n\t}\n\n\tconst record = payload as Record<string, unknown>;\n\tif (record.kind !== 'shader-compilation') {\n\t\treturn null;\n\t}\n\tif (\n\t\trecord.shaderStage !== undefined &&\n\t\trecord.shaderStage !== 'fragment' &&\n\t\trecord.shaderStage !== 'compute'\n\t) {\n\t\treturn null;\n\t}\n\tif (\n\t\t!Array.isArray(record.diagnostics) ||\n\t\t!record.diagnostics.every(isShaderCompilationDiagnostic)\n\t) {\n\t\treturn null;\n\t}\n\tif (typeof record.fragmentSource !== 'string') {\n\t\treturn null;\n\t}\n\tif (record.computeSource !== undefined && typeof record.computeSource !== 'string') {\n\t\treturn null;\n\t}\n\tif (record.defineBlockSource !== undefined && typeof record.defineBlockSource !== 'string') {\n\t\treturn null;\n\t}\n\tif (record.includeSources === null || typeof record.includeSources !== 'object') {\n\t\treturn null;\n\t}\n\tconst includeSources = record.includeSources as Record<string, unknown>;\n\tif (Object.values(includeSources).some((value) => typeof value !== 'string')) {\n\t\treturn null;\n\t}\n\tif (record.materialSource !== null && !isMaterialSourceMetadata(record.materialSource)) {\n\t\treturn null;\n\t}\n\tif (\n\t\trecord.runtimeContext !== undefined &&\n\t\t!isShaderCompilationRuntimeContext(record.runtimeContext)\n\t) {\n\t\treturn null;\n\t}\n\n\treturn {\n\t\tkind: 'shader-compilation',\n\t\t...(record.shaderStage !== undefined\n\t\t\t? { shaderStage: record.shaderStage as 'fragment' | 'compute' }\n\t\t\t: {}),\n\t\tdiagnostics: record.diagnostics as ShaderCompilationDiagnostic[],\n\t\tfragmentSource: record.fragmentSource,\n\t\t...(record.computeSource !== undefined\n\t\t\t? { computeSource: record.computeSource as string }\n\t\t\t: {}),\n\t\tincludeSources: includeSources as Record<string, string>,\n\t\t...(record.defineBlockSource !== undefined\n\t\t\t? { defineBlockSource: record.defineBlockSource as string }\n\t\t\t: {}),\n\t\tmaterialSource: (record.materialSource ?? null) as MaterialSourceMetadata | null,\n\t\t...(record.runtimeContext !== undefined\n\t\t\t? { runtimeContext: record.runtimeContext as ShaderCompilationRuntimeContext }\n\t\t\t: {})\n\t};\n}\n"],"mappings":";AAgEA,SAAS,yBAAyB,OAAiD;AAClF,KAAI,UAAU,QAAQ,OAAO,UAAU,SACtC,QAAO;CAGR,MAAM,SAAS;AACf,KAAI,OAAO,cAAc,UAAa,OAAO,OAAO,cAAc,SACjE,QAAO;AAER,KAAI,OAAO,SAAS,UAAa,OAAO,OAAO,SAAS,SACvD,QAAO;AAER,KAAI,OAAO,iBAAiB,UAAa,OAAO,OAAO,iBAAiB,SACvE,QAAO;AAER,KAAI,OAAO,SAAS,UAAa,OAAO,OAAO,SAAS,SACvD,QAAO;AAER,KAAI,OAAO,WAAW,UAAa,OAAO,OAAO,WAAW,SAC3D,QAAO;AAGR,QAAO;;AAGR,SAAS,uBAAuB,OAAsD;AACrF,KAAI,UAAU,KACb,QAAO;AAGR,KAAI,OAAO,UAAU,SACpB,QAAO;CAGR,MAAM,SAAS;CACf,MAAM,OAAO,OAAO;AACpB,KAAI,SAAS,cAAc,SAAS,aAAa,SAAS,YAAY,SAAS,UAC9E,QAAO;AAGR,QAAO,OAAO,OAAO,SAAS;;AAG/B,SAAS,8BAA8B,OAAsD;AAC5F,KAAI,UAAU,QAAQ,OAAO,UAAU,SACtC,QAAO;CAGR,MAAM,SAAS;AACf,KAAI,OAAO,OAAO,kBAAkB,SACnC,QAAO;AAER,KAAI,OAAO,OAAO,YAAY,SAC7B,QAAO;AAER,KAAI,OAAO,YAAY,UAAa,OAAO,OAAO,YAAY,SAC7D,QAAO;AAER,KAAI,OAAO,eAAe,UAAa,OAAO,OAAO,eAAe,SACnE,QAAO;AAER,KAAI,CAAC,uBAAuB,OAAO,eAAe,CACjD,QAAO;AAGR,QAAO;;AAGR,SAAS,cAAc,OAAmC;AACzD,QAAO,MAAM,QAAQ,MAAM,IAAI,MAAM,OAAO,UAAU,OAAO,UAAU,SAAS;;AAGjF,SAAS,kCACR,OAC2C;AAC3C,KAAI,UAAU,QAAQ,OAAO,UAAU,SACtC,QAAO;CAGR,MAAM,SAAS;AACf,KAAI,OAAO,sBAAsB,UAAa,OAAO,OAAO,sBAAsB,SACjF,QAAO;AAER,KAAI,CAAC,cAAc,OAAO,oBAAoB,CAC7C,QAAO;CAER,MAAM,YAAY,OAAO;AACzB,KAAI,cAAc,OACjB,QAAO;AAER,KAAI,cAAc,QAAQ,OAAO,cAAc,SAC9C,QAAO;CAGR,MAAM,kBAAkB;AACxB,KAAI,OAAO,gBAAgB,cAAc,SACxC,QAAO;AAER,KAAI,OAAO,gBAAgB,qBAAqB,SAC/C,QAAO;AAER,KAAI,CAAC,cAAc,gBAAgB,OAAO,IAAI,CAAC,cAAc,gBAAgB,QAAQ,CACpF,QAAO;AAGR,QAAO;;;;;AAMR,SAAgB,mCACf,OACA,SACQ;AACP,OAAwC,uBAAuB;AAChE,QAAO;;;;;AAMR,SAAgB,gCACf,OAC6C;AAC7C,KAAI,EAAE,iBAAiB,OACtB,QAAO;CAGR,MAAM,UAAW,MAAwC;AACzD,KAAI,YAAY,QAAQ,OAAO,YAAY,SAC1C,QAAO;CAGR,MAAM,SAAS;AACf,KAAI,OAAO,SAAS,qBACnB,QAAO;AAER,KACC,OAAO,gBAAgB,UACvB,OAAO,gBAAgB,cACvB,OAAO,gBAAgB,UAEvB,QAAO;AAER,KACC,CAAC,MAAM,QAAQ,OAAO,YAAY,IAClC,CAAC,OAAO,YAAY,MAAM,8BAA8B,CAExD,QAAO;AAER,KAAI,OAAO,OAAO,mBAAmB,SACpC,QAAO;AAER,KAAI,OAAO,kBAAkB,UAAa,OAAO,OAAO,kBAAkB,SACzE,QAAO;AAER,KAAI,OAAO,sBAAsB,UAAa,OAAO,OAAO,sBAAsB,SACjF,QAAO;AAER,KAAI,OAAO,mBAAmB,QAAQ,OAAO,OAAO,mBAAmB,SACtE,QAAO;CAER,MAAM,iBAAiB,OAAO;AAC9B,KAAI,OAAO,OAAO,eAAe,CAAC,MAAM,UAAU,OAAO,UAAU,SAAS,CAC3E,QAAO;AAER,KAAI,OAAO,mBAAmB,QAAQ,CAAC,yBAAyB,OAAO,eAAe,CACrF,QAAO;AAER,KACC,OAAO,mBAAmB,UAC1B,CAAC,kCAAkC,OAAO,eAAe,CAEzD,QAAO;AAGR,QAAO;EACN,MAAM;EACN,GAAI,OAAO,gBAAgB,SACxB,EAAE,aAAa,OAAO,aAAuC,GAC7D,EAAE;EACL,aAAa,OAAO;EACpB,gBAAgB,OAAO;EACvB,GAAI,OAAO,kBAAkB,SAC1B,EAAE,eAAe,OAAO,eAAyB,GACjD,EAAE;EACW;EAChB,GAAI,OAAO,sBAAsB,SAC9B,EAAE,mBAAmB,OAAO,mBAA6B,GACzD,EAAE;EACL,gBAAiB,OAAO,kBAAkB;EAC1C,GAAI,OAAO,mBAAmB,SAC3B,EAAE,gBAAgB,OAAO,gBAAmD,GAC5E,EAAE;EACL"}

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

@@ -1 +1 @@
-{"version":3,"file":"error-report.d.ts","sourceRoot":"","sources":["../../src/lib/core/error-report.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC3B,oBAAoB,GACpB,4BAA4B,GAC5B,4BAA4B,GAC5B,yBAAyB,GACzB,4BAA4B,GAC5B,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,0BAA0B,GAC1B,uBAAuB,GACvB,8BAA8B,GAC9B,4BAA4B,GAC5B,sBAAsB,GACtB,gCAAgC,GAChC,uBAAuB,GACvB,wBAAwB,GACxB,4BAA4B,GAC5B,yBAAyB,GACzB,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,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,oBAAoB;IACpC;;OAEG;IACH,IAAI,EAAE,kBAAkB,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,sBAAsB,CAAC;IACjC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC;;OAEG;IACH,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACtC;AAoWD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,mBAAmB,GACxB,oBAAoB,CAwCtB"}
+{"version":3,"file":"error-report.d.ts","sourceRoot":"","sources":["../../src/lib/core/error-report.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG,QAAQ,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC3B,oBAAoB,GACpB,4BAA4B,GAC5B,4BAA4B,GAC5B,yBAAyB,GACzB,4BAA4B,GAC5B,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,0BAA0B,GAC1B,uBAAuB,GACvB,8BAA8B,GAC9B,4BAA4B,GAC5B,sBAAsB,GACtB,gCAAgC,GAChC,uBAAuB,GACvB,wBAAwB,GACxB,4BAA4B,GAC5B,yBAAyB,GACzB,4BAA4B,GAC5B,0BAA0B,GAC1B,yBAAyB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,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,oBAAoB;IACpC;;OAEG;IACH,IAAI,EAAE,kBAAkB,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,sBAAsB,CAAC;IACjC;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,EAAE,mBAAmB,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC;;OAEG;IACH,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACtC;AAiXD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,mBAAmB,GACxB,oBAAoB,CAoDtB"}

package/dist/core/error-report.js

@@ -55,6 +55,17 @@ function buildSourceFromDiagnostics(error) {
 			snippet: toSnippet(includeSource, location.line)
 		};
 	}
+	if (location.kind === "compute") {
+		const computeSource = diagnostics.computeSource ?? diagnostics.fragmentSource;
+		const component = "Compute shader";
+		return {
+			component,
+			location: `${component} (${formatShaderSourceLocation(location) ?? `compute line ${location.line}`})`,
+			line: location.line,
+			...column !== void 0 ? { column } : {},
+			snippet: toSnippet(computeSource, location.line)
+		};
+	}
 	const defineName = location.define ?? "unknown";
 	const defineLine = Math.max(1, location.line);
 	const component = `#define ${defineName}`;
@@ -241,7 +252,14 @@ function toMotionGPUErrorReport(error, phase) {
 	const message = shaderDiagnostics && shaderDiagnostics.diagnostics[0] ? formatDiagnosticMessage(shaderDiagnostics.diagnostics[0]) : defaultMessage;
 	const details = shaderDiagnostics ? shaderDiagnostics.diagnostics.slice(1).map((entry) => formatDiagnosticMessage(entry)) : defaultDetails;
 	const stack = error instanceof Error && error.stack ? splitLines(error.stack).filter((line) => line !== message) : [];
-	const classification = classifyErrorMessage(rawMessage);
+	let classification = classifyErrorMessage(rawMessage);
+	if (shaderDiagnostics?.shaderStage === "compute" && classification.code === "WGSL_COMPILATION_FAILED") classification = {
+		code: "COMPUTE_COMPILATION_FAILED",
+		severity: "error",
+		recoverable: true,
+		title: "Compute shader compilation failed",
+		hint: "Check WGSL compute shader sources below and verify storage bindings."
+	};
 	return {
 		code: classification.code,
 		severity: classification.severity,