@motion-core/motion-gpu 0.4.1 → 0.5.0

package/dist/core/uniforms.js

@@ -1,222 +1,201 @@
+//#region src/lib/core/uniforms.ts
 /**
- * Valid WGSL identifier pattern used for uniform and texture keys.
- */
-const IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+* Valid WGSL identifier pattern used for uniform and texture keys.
+*/
+var IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 /**
- * Rounds a value up to the nearest multiple of `alignment`.
- */
+* Rounds a value up to the nearest multiple of `alignment`.
+*/
 function roundUp(value, alignment) {
-    return Math.ceil(value / alignment) * alignment;
+	return Math.ceil(value / alignment) * alignment;
 }
 /**
- * Returns WGSL std140-like alignment and size metadata for a uniform type.
- */
+* Returns WGSL std140-like alignment and size metadata for a uniform type.
+*/
 function getTypeLayout(type) {
-    switch (type) {
-        case 'f32':
-            return { alignment: 4, size: 4 };
-        case 'vec2f':
-            return { alignment: 8, size: 8 };
-        case 'vec3f':
-            return { alignment: 16, size: 12 };
-        case 'vec4f':
-            return { alignment: 16, size: 16 };
-        case 'mat4x4f':
-            return { alignment: 16, size: 64 };
-        default:
-            throw new Error(`Unsupported uniform type: ${type}`);
-    }
+	switch (type) {
+		case "f32": return {
+			alignment: 4,
+			size: 4
+		};
+		case "vec2f": return {
+			alignment: 8,
+			size: 8
+		};
+		case "vec3f": return {
+			alignment: 16,
+			size: 12
+		};
+		case "vec4f": return {
+			alignment: 16,
+			size: 16
+		};
+		case "mat4x4f": return {
+			alignment: 16,
+			size: 64
+		};
+		default: throw new Error(`Unsupported uniform type: ${type}`);
+	}
 }
 /**
- * Type guard for explicitly typed uniform objects.
- */
+* Type guard for explicitly typed uniform objects.
+*/
 function isTypedUniformValue(value) {
-    return typeof value === 'object' && value !== null && 'type' in value && 'value' in value;
+	return typeof value === "object" && value !== null && "type" in value && "value" in value;
 }
 /**
- * Validates numeric tuple input with a fixed length.
- */
+* Validates numeric tuple input with a fixed length.
+*/
 function isTuple(value, size) {
-    return (Array.isArray(value) &&
-        value.length === size &&
-        value.every((entry) => typeof entry === 'number' && Number.isFinite(entry)));
+	return Array.isArray(value) && value.length === size && value.every((entry) => typeof entry === "number" && Number.isFinite(entry));
 }
 /**
- * Type guard for accepted 4x4 matrix uniform values.
- */
+* Type guard for accepted 4x4 matrix uniform values.
+*/
 function isMat4Value(value) {
-    if (value instanceof Float32Array) {
-        return value.length === 16;
-    }
-    return (Array.isArray(value) &&
-        value.length === 16 &&
-        value.every((entry) => typeof entry === 'number' && Number.isFinite(entry)));
+	if (value instanceof Float32Array) return value.length === 16;
+	return Array.isArray(value) && value.length === 16 && value.every((entry) => typeof entry === "number" && Number.isFinite(entry));
 }
 /**
- * Asserts that a name can be safely used as a WGSL identifier.
- *
- * @param name - Candidate uniform/texture name.
- * @throws {Error} When the identifier is invalid.
- */
-export function assertUniformName(name) {
-    if (!IDENTIFIER_PATTERN.test(name)) {
-        throw new Error(`Invalid uniform name: ${name}`);
-    }
+* Asserts that a name can be safely used as a WGSL identifier.
+*
+* @param name - Candidate uniform/texture name.
+* @throws {Error} When the identifier is invalid.
+*/
+function assertUniformName(name) {
+	if (!IDENTIFIER_PATTERN.test(name)) throw new Error(`Invalid uniform name: ${name}`);
 }
 /**
- * Infers the WGSL type tag from a runtime uniform value.
- *
- * @param value - Uniform input value.
- * @returns Inferred uniform type.
- * @throws {Error} When the value does not match any supported shape.
- */
-export function inferUniformType(value) {
-    if (isTypedUniformValue(value)) {
-        return value.type;
-    }
-    if (typeof value === 'number') {
-        return 'f32';
-    }
-    if (Array.isArray(value)) {
-        if (value.length === 2) {
-            return 'vec2f';
-        }
-        if (value.length === 3) {
-            return 'vec3f';
-        }
-        if (value.length === 4) {
-            return 'vec4f';
-        }
-    }
-    throw new Error('Uniform value must resolve to f32, vec2f, vec3f, vec4f or mat4x4f');
+* Infers the WGSL type tag from a runtime uniform value.
+*
+* @param value - Uniform input value.
+* @returns Inferred uniform type.
+* @throws {Error} When the value does not match any supported shape.
+*/
+function inferUniformType(value) {
+	if (isTypedUniformValue(value)) return value.type;
+	if (typeof value === "number") return "f32";
+	if (Array.isArray(value)) {
+		if (value.length === 2) return "vec2f";
+		if (value.length === 3) return "vec3f";
+		if (value.length === 4) return "vec4f";
+	}
+	throw new Error("Uniform value must resolve to f32, vec2f, vec3f, vec4f or mat4x4f");
 }
 /**
- * Validates that a uniform value matches an explicit uniform type declaration.
- *
- * @param type - Declared WGSL type.
- * @param value - Runtime value to validate.
- * @throws {Error} When the value shape is incompatible with the declared type.
- */
-export function assertUniformValueForType(type, value) {
-    const input = isTypedUniformValue(value) ? value.value : value;
-    if (type === 'f32') {
-        if (typeof input !== 'number' || !Number.isFinite(input)) {
-            throw new Error('Uniform f32 value must be a finite number');
-        }
-        return;
-    }
-    if (type === 'vec2f') {
-        if (!isTuple(input, 2)) {
-            throw new Error('Uniform vec2f value must be a tuple with 2 numbers');
-        }
-        return;
-    }
-    if (type === 'vec3f') {
-        if (!isTuple(input, 3)) {
-            throw new Error('Uniform vec3f value must be a tuple with 3 numbers');
-        }
-        return;
-    }
-    if (type === 'vec4f') {
-        if (!isTuple(input, 4)) {
-            throw new Error('Uniform vec4f value must be a tuple with 4 numbers');
-        }
-        return;
-    }
-    if (!isMat4Value(input)) {
-        throw new Error('Uniform mat4x4f value must contain 16 numbers');
-    }
+* Validates that a uniform value matches an explicit uniform type declaration.
+*
+* @param type - Declared WGSL type.
+* @param value - Runtime value to validate.
+* @throws {Error} When the value shape is incompatible with the declared type.
+*/
+function assertUniformValueForType(type, value) {
+	const input = isTypedUniformValue(value) ? value.value : value;
+	if (type === "f32") {
+		if (typeof input !== "number" || !Number.isFinite(input)) throw new Error("Uniform f32 value must be a finite number");
+		return;
+	}
+	if (type === "vec2f") {
+		if (!isTuple(input, 2)) throw new Error("Uniform vec2f value must be a tuple with 2 numbers");
+		return;
+	}
+	if (type === "vec3f") {
+		if (!isTuple(input, 3)) throw new Error("Uniform vec3f value must be a tuple with 3 numbers");
+		return;
+	}
+	if (type === "vec4f") {
+		if (!isTuple(input, 4)) throw new Error("Uniform vec4f value must be a tuple with 4 numbers");
+		return;
+	}
+	if (!isMat4Value(input)) throw new Error("Uniform mat4x4f value must contain 16 numbers");
 }
 /**
- * Resolves a deterministic packed uniform buffer layout from a uniform map.
- *
- * @param uniforms - Input uniform definitions.
- * @returns Sorted layout with byte offsets and final buffer byte length.
- */
-export function resolveUniformLayout(uniforms) {
-    const names = Object.keys(uniforms).sort();
-    let offset = 0;
-    const entries = [];
-    const byName = {};
-    for (const name of names) {
-        assertUniformName(name);
-        const type = inferUniformType(uniforms[name]);
-        const { alignment, size } = getTypeLayout(type);
-        offset = roundUp(offset, alignment);
-        const entry = {
-            name,
-            type,
-            offset,
-            size
-        };
-        entries.push(entry);
-        byName[name] = entry;
-        offset += size;
-    }
-    const byteLength = Math.max(16, roundUp(offset, 16));
-    return { entries, byName, byteLength };
+* Resolves a deterministic packed uniform buffer layout from a uniform map.
+*
+* @param uniforms - Input uniform definitions.
+* @returns Sorted layout with byte offsets and final buffer byte length.
+*/
+function resolveUniformLayout(uniforms) {
+	const names = Object.keys(uniforms).sort();
+	let offset = 0;
+	const entries = [];
+	const byName = {};
+	for (const name of names) {
+		assertUniformName(name);
+		const type = inferUniformType(uniforms[name]);
+		const { alignment, size } = getTypeLayout(type);
+		offset = roundUp(offset, alignment);
+		const entry = {
+			name,
+			type,
+			offset,
+			size
+		};
+		entries.push(entry);
+		byName[name] = entry;
+		offset += size;
+	}
+	return {
+		entries,
+		byName,
+		byteLength: Math.max(16, roundUp(offset, 16))
+	};
 }
 /**
- * Writes one validated uniform value directly into the output float buffer.
- */
+* Writes one validated uniform value directly into the output float buffer.
+*/
 function writeUniformValue(type, value, data, base) {
-    const input = isTypedUniformValue(value) ? value.value : value;
-    assertUniformValueForType(type, value);
-    if (type === 'f32') {
-        data[base] = input;
-        return;
-    }
-    if (type === 'mat4x4f') {
-        const matrix = input;
-        if (matrix instanceof Float32Array) {
-            for (let index = 0; index < 16; index += 1) {
-                data[base + index] = matrix[index] ?? 0;
-            }
-            return;
-        }
-        for (let index = 0; index < 16; index += 1) {
-            data[base + index] = matrix[index] ?? 0;
-        }
-        return;
-    }
-    const tuple = input;
-    const length = type === 'vec2f' ? 2 : type === 'vec3f' ? 3 : 4;
-    for (let index = 0; index < length; index += 1) {
-        data[base + index] = tuple[index] ?? 0;
-    }
+	const input = isTypedUniformValue(value) ? value.value : value;
+	assertUniformValueForType(type, value);
+	if (type === "f32") {
+		data[base] = input;
+		return;
+	}
+	if (type === "mat4x4f") {
+		const matrix = input;
+		if (matrix instanceof Float32Array) {
+			for (let index = 0; index < 16; index += 1) data[base + index] = matrix[index] ?? 0;
+			return;
+		}
+		for (let index = 0; index < 16; index += 1) data[base + index] = matrix[index] ?? 0;
+		return;
+	}
+	const tuple = input;
+	const length = type === "vec2f" ? 2 : type === "vec3f" ? 3 : 4;
+	for (let index = 0; index < length; index += 1) data[base + index] = tuple[index] ?? 0;
 }
 /**
- * Packs uniforms into a newly allocated `Float32Array`.
- *
- * @param uniforms - Uniform values to pack.
- * @param layout - Target layout definition.
- * @returns Packed float buffer sized to `layout.byteLength`.
- */
-export function packUniforms(uniforms, layout) {
-    const data = new Float32Array(layout.byteLength / 4);
-    packUniformsInto(uniforms, layout, data);
-    return data;
+* Packs uniforms into a newly allocated `Float32Array`.
+*
+* @param uniforms - Uniform values to pack.
+* @param layout - Target layout definition.
+* @returns Packed float buffer sized to `layout.byteLength`.
+*/
+function packUniforms(uniforms, layout) {
+	const data = new Float32Array(layout.byteLength / 4);
+	packUniformsInto(uniforms, layout, data);
+	return data;
 }
 /**
- * Packs uniforms into an existing output buffer and zeroes missing values.
- *
- * @param uniforms - Uniform values to pack.
- * @param layout - Target layout metadata.
- * @param data - Destination float buffer.
- * @throws {Error} When `data` size does not match the required layout size.
- */
-export function packUniformsInto(uniforms, layout, data) {
-    const requiredLength = layout.byteLength / 4;
-    if (data.length !== requiredLength) {
-        throw new Error(`Uniform output buffer size mismatch. Expected ${requiredLength}, got ${data.length}`);
-    }
-    data.fill(0);
-    for (const entry of layout.entries) {
-        const raw = uniforms[entry.name];
-        if (raw === undefined) {
-            continue;
-        }
-        const base = entry.offset / 4;
-        writeUniformValue(entry.type, raw, data, base);
-    }
+* Packs uniforms into an existing output buffer and zeroes missing values.
+*
+* @param uniforms - Uniform values to pack.
+* @param layout - Target layout metadata.
+* @param data - Destination float buffer.
+* @throws {Error} When `data` size does not match the required layout size.
+*/
+function packUniformsInto(uniforms, layout, data) {
+	const requiredLength = layout.byteLength / 4;
+	if (data.length !== requiredLength) throw new Error(`Uniform output buffer size mismatch. Expected ${requiredLength}, got ${data.length}`);
+	data.fill(0);
+	for (const entry of layout.entries) {
+		const raw = uniforms[entry.name];
+		if (raw === void 0) continue;
+		const base = entry.offset / 4;
+		writeUniformValue(entry.type, raw, data, base);
+	}
 }
+//#endregion
+export { assertUniformName, assertUniformValueForType, inferUniformType, packUniforms, packUniformsInto, resolveUniformLayout };
+
+//# sourceMappingURL=uniforms.js.map

package/dist/core/uniforms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniforms.js","names":[],"sources":["../../src/lib/core/uniforms.ts"],"sourcesContent":["import type {\n\tUniformLayout,\n\tUniformLayoutEntry,\n\tUniformMap,\n\tUniformMat4Value,\n\tUniformType,\n\tUniformValue\n} from './types.js';\n\n/**\n * Internal representation of explicitly typed uniform input.\n */\ntype UniformTypedInput = Extract<UniformValue, { type: UniformType; value: unknown }>;\n\n/**\n * Valid WGSL identifier pattern used for uniform and texture keys.\n */\nconst IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * Rounds a value up to the nearest multiple of `alignment`.\n */\nfunction roundUp(value: number, alignment: number): number {\n\treturn Math.ceil(value / alignment) * alignment;\n}\n\n/**\n * Returns WGSL std140-like alignment and size metadata for a uniform type.\n */\nfunction getTypeLayout(type: UniformType): { alignment: number; size: number } {\n\tswitch (type) {\n\t\tcase 'f32':\n\t\t\treturn { alignment: 4, size: 4 };\n\t\tcase 'vec2f':\n\t\t\treturn { alignment: 8, size: 8 };\n\t\tcase 'vec3f':\n\t\t\treturn { alignment: 16, size: 12 };\n\t\tcase 'vec4f':\n\t\t\treturn { alignment: 16, size: 16 };\n\t\tcase 'mat4x4f':\n\t\t\treturn { alignment: 16, size: 64 };\n\t\tdefault:\n\t\t\tthrow new Error(`Unsupported uniform type: ${type satisfies never}`);\n\t}\n}\n\n/**\n * Type guard for explicitly typed uniform objects.\n */\nfunction isTypedUniformValue(value: UniformValue): value is UniformTypedInput {\n\treturn typeof value === 'object' && value !== null && 'type' in value && 'value' in value;\n}\n\n/**\n * Validates numeric tuple input with a fixed length.\n */\nfunction isTuple(value: unknown, size: number): value is number[] {\n\treturn (\n\t\tArray.isArray(value) &&\n\t\tvalue.length === size &&\n\t\tvalue.every((entry) => typeof entry === 'number' && Number.isFinite(entry))\n\t);\n}\n\n/**\n * Type guard for accepted 4x4 matrix uniform values.\n */\nfunction isMat4Value(value: unknown): value is UniformMat4Value {\n\tif (value instanceof Float32Array) {\n\t\treturn value.length === 16;\n\t}\n\n\treturn (\n\t\tArray.isArray(value) &&\n\t\tvalue.length === 16 &&\n\t\tvalue.every((entry) => typeof entry === 'number' && Number.isFinite(entry))\n\t);\n}\n\n/**\n * Asserts that a name can be safely used as a WGSL identifier.\n *\n * @param name - Candidate uniform/texture name.\n * @throws {Error} When the identifier is invalid.\n */\nexport function assertUniformName(name: string): void {\n\tif (!IDENTIFIER_PATTERN.test(name)) {\n\t\tthrow new Error(`Invalid uniform name: ${name}`);\n\t}\n}\n\n/**\n * Infers the WGSL type tag from a runtime uniform value.\n *\n * @param value - Uniform input value.\n * @returns Inferred uniform type.\n * @throws {Error} When the value does not match any supported shape.\n */\nexport function inferUniformType(value: UniformValue): UniformType {\n\tif (isTypedUniformValue(value)) {\n\t\treturn value.type;\n\t}\n\n\tif (typeof value === 'number') {\n\t\treturn 'f32';\n\t}\n\n\tif (Array.isArray(value)) {\n\t\tif (value.length === 2) {\n\t\t\treturn 'vec2f';\n\t\t}\n\t\tif (value.length === 3) {\n\t\t\treturn 'vec3f';\n\t\t}\n\t\tif (value.length === 4) {\n\t\t\treturn 'vec4f';\n\t\t}\n\t}\n\n\tthrow new Error('Uniform value must resolve to f32, vec2f, vec3f, vec4f or mat4x4f');\n}\n\n/**\n * Validates that a uniform value matches an explicit uniform type declaration.\n *\n * @param type - Declared WGSL type.\n * @param value - Runtime value to validate.\n * @throws {Error} When the value shape is incompatible with the declared type.\n */\nexport function assertUniformValueForType(type: UniformType, value: UniformValue): void {\n\tconst input = isTypedUniformValue(value) ? value.value : value;\n\n\tif (type === 'f32') {\n\t\tif (typeof input !== 'number' || !Number.isFinite(input)) {\n\t\t\tthrow new Error('Uniform f32 value must be a finite number');\n\t\t}\n\t\treturn;\n\t}\n\n\tif (type === 'vec2f') {\n\t\tif (!isTuple(input, 2)) {\n\t\t\tthrow new Error('Uniform vec2f value must be a tuple with 2 numbers');\n\t\t}\n\t\treturn;\n\t}\n\n\tif (type === 'vec3f') {\n\t\tif (!isTuple(input, 3)) {\n\t\t\tthrow new Error('Uniform vec3f value must be a tuple with 3 numbers');\n\t\t}\n\t\treturn;\n\t}\n\n\tif (type === 'vec4f') {\n\t\tif (!isTuple(input, 4)) {\n\t\t\tthrow new Error('Uniform vec4f value must be a tuple with 4 numbers');\n\t\t}\n\t\treturn;\n\t}\n\n\tif (!isMat4Value(input)) {\n\t\tthrow new Error('Uniform mat4x4f value must contain 16 numbers');\n\t}\n}\n\n/**\n * Resolves a deterministic packed uniform buffer layout from a uniform map.\n *\n * @param uniforms - Input uniform definitions.\n * @returns Sorted layout with byte offsets and final buffer byte length.\n */\nexport function resolveUniformLayout(uniforms: UniformMap): UniformLayout {\n\tconst names = Object.keys(uniforms).sort();\n\tlet offset = 0;\n\tconst entries: UniformLayoutEntry[] = [];\n\tconst byName: Record<string, UniformLayoutEntry> = {};\n\n\tfor (const name of names) {\n\t\tassertUniformName(name);\n\t\tconst type = inferUniformType(uniforms[name] as UniformValue);\n\t\tconst { alignment, size } = getTypeLayout(type);\n\t\toffset = roundUp(offset, alignment);\n\n\t\tconst entry: UniformLayoutEntry = {\n\t\t\tname,\n\t\t\ttype,\n\t\t\toffset,\n\t\t\tsize\n\t\t};\n\n\t\tentries.push(entry);\n\t\tbyName[name] = entry;\n\t\toffset += size;\n\t}\n\n\tconst byteLength = Math.max(16, roundUp(offset, 16));\n\treturn { entries, byName, byteLength };\n}\n\n/**\n * Writes one validated uniform value directly into the output float buffer.\n */\nfunction writeUniformValue(\n\ttype: UniformType,\n\tvalue: UniformValue,\n\tdata: Float32Array,\n\tbase: number\n): void {\n\tconst input = isTypedUniformValue(value) ? value.value : value;\n\tassertUniformValueForType(type, value);\n\n\tif (type === 'f32') {\n\t\tdata[base] = input as number;\n\t\treturn;\n\t}\n\n\tif (type === 'mat4x4f') {\n\t\tconst matrix = input as UniformMat4Value;\n\t\tif (matrix instanceof Float32Array) {\n\t\t\tfor (let index = 0; index < 16; index += 1) {\n\t\t\t\tdata[base + index] = matrix[index] ?? 0;\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\tfor (let index = 0; index < 16; index += 1) {\n\t\t\tdata[base + index] = matrix[index] ?? 0;\n\t\t}\n\t\treturn;\n\t}\n\n\tconst tuple = input as number[];\n\tconst length = type === 'vec2f' ? 2 : type === 'vec3f' ? 3 : 4;\n\tfor (let index = 0; index < length; index += 1) {\n\t\tdata[base + index] = tuple[index] ?? 0;\n\t}\n}\n\n/**\n * Packs uniforms into a newly allocated `Float32Array`.\n *\n * @param uniforms - Uniform values to pack.\n * @param layout - Target layout definition.\n * @returns Packed float buffer sized to `layout.byteLength`.\n */\nexport function packUniforms(uniforms: UniformMap, layout: UniformLayout): Float32Array {\n\tconst data = new Float32Array(layout.byteLength / 4);\n\tpackUniformsInto(uniforms, layout, data);\n\treturn data;\n}\n\n/**\n * Packs uniforms into an existing output buffer and zeroes missing values.\n *\n * @param uniforms - Uniform values to pack.\n * @param layout - Target layout metadata.\n * @param data - Destination float buffer.\n * @throws {Error} When `data` size does not match the required layout size.\n */\nexport function packUniformsInto(\n\tuniforms: UniformMap,\n\tlayout: UniformLayout,\n\tdata: Float32Array\n): void {\n\tconst requiredLength = layout.byteLength / 4;\n\tif (data.length !== requiredLength) {\n\t\tthrow new Error(\n\t\t\t`Uniform output buffer size mismatch. Expected ${requiredLength}, got ${data.length}`\n\t\t);\n\t}\n\n\tdata.fill(0);\n\tfor (const entry of layout.entries) {\n\t\tconst raw = uniforms[entry.name];\n\t\tif (raw === undefined) {\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst base = entry.offset / 4;\n\t\twriteUniformValue(entry.type, raw, data, base);\n\t}\n}\n"],"mappings":"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"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,6 +1,13 @@
-/**
- * Root package entrypoint.
- *
- * Framework-agnostic core entrypoint.
- */
-export * from './core/index.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 "./core/index.js";
+export { BlitPass, ComputePass, CopyPass, PingPongComputePass, ShaderPass, createCurrentWritable, createFrameRegistry, createMotionGPURuntimeLoop, defineMaterial, loadTexturesFromUrls, resolveMaterial, toMotionGPUErrorReport };

package/dist/passes/BlitPass.d.ts

@@ -9,3 +9,4 @@ export declare class BlitPass extends FullscreenPass {
     protected getVertexEntryPoint(): string;
     protected getFragmentEntryPoint(): string;
 }
+//# sourceMappingURL=BlitPass.d.ts.map

package/dist/passes/BlitPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlitPass.d.ts","sourceRoot":"","sources":["../../src/lib/passes/BlitPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAgCjF,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAC;AAEpD;;GAEG;AACH,qBAAa,QAAS,SAAQ,cAAc;IAC3C,SAAS,CAAC,UAAU,IAAI,MAAM;gBAIlB,OAAO,GAAE,eAAoB;IAIzC,SAAS,CAAC,mBAAmB,IAAI,MAAM;IAIvC,SAAS,CAAC,qBAAqB,IAAI,MAAM;CAGzC"}

package/dist/passes/BlitPass.js

@@ -1,5 +1,6 @@
-import { FullscreenPass } from './FullscreenPass.js';
-const FULLSCREEN_BLIT_SHADER = `
+import { FullscreenPass } from "./FullscreenPass.js";
+//#region src/lib/passes/BlitPass.ts
+var FULLSCREEN_BLIT_SHADER = `
 struct MotionGPUVertexOut {
 	@builtin(position) position: vec4f,
 	@location(0) uv: vec2f,
@@ -29,19 +30,23 @@ fn motiongpuBlitFragment(in: MotionGPUVertexOut) -> @location(0) vec4f {
 }
 `;
 /**
- * Fullscreen texture blit pass.
- */
-export class BlitPass extends FullscreenPass {
-    getProgram() {
-        return FULLSCREEN_BLIT_SHADER;
-    }
-    constructor(options = {}) {
-        super(options);
-    }
-    getVertexEntryPoint() {
-        return 'motiongpuBlitVertex';
-    }
-    getFragmentEntryPoint() {
-        return 'motiongpuBlitFragment';
-    }
-}
+* Fullscreen texture blit pass.
+*/
+var BlitPass = class extends FullscreenPass {
+	getProgram() {
+		return FULLSCREEN_BLIT_SHADER;
+	}
+	constructor(options = {}) {
+		super(options);
+	}
+	getVertexEntryPoint() {
+		return "motiongpuBlitVertex";
+	}
+	getFragmentEntryPoint() {
+		return "motiongpuBlitFragment";
+	}
+};
+//#endregion
+export { BlitPass };
+
+//# sourceMappingURL=BlitPass.js.map

package/dist/passes/BlitPass.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlitPass.js","names":[],"sources":["../../src/lib/passes/BlitPass.ts"],"sourcesContent":["import { FullscreenPass, type FullscreenPassOptions } from './FullscreenPass.js';\n\nconst FULLSCREEN_BLIT_SHADER = `\nstruct MotionGPUVertexOut {\n\t@builtin(position) position: vec4f,\n\t@location(0) uv: vec2f,\n};\n\n@group(0) @binding(0) var motiongpuBlitSampler: sampler;\n@group(0) @binding(1) var motiongpuBlitTexture: texture_2d<f32>;\n\n@vertex\nfn motiongpuBlitVertex(@builtin(vertex_index) index: u32) -> MotionGPUVertexOut {\n\tvar positions = array<vec2f, 3>(\n\t\tvec2f(-1.0, -3.0),\n\t\tvec2f(-1.0, 1.0),\n\t\tvec2f(3.0, 1.0)\n\t);\n\n\tlet position = positions[index];\n\tvar out: MotionGPUVertexOut;\n\tout.position = vec4f(position, 0.0, 1.0);\n\tout.uv = (position + vec2f(1.0, 1.0)) * 0.5;\n\treturn out;\n}\n\n@fragment\nfn motiongpuBlitFragment(in: MotionGPUVertexOut) -> @location(0) vec4f {\n\treturn textureSample(motiongpuBlitTexture, motiongpuBlitSampler, in.uv);\n}\n`;\n\nexport type BlitPassOptions = FullscreenPassOptions;\n\n/**\n * Fullscreen texture blit pass.\n */\nexport class BlitPass extends FullscreenPass {\n\tprotected getProgram(): string {\n\t\treturn FULLSCREEN_BLIT_SHADER;\n\t}\n\n\tconstructor(options: BlitPassOptions = {}) {\n\t\tsuper(options);\n\t}\n\n\tprotected getVertexEntryPoint(): string {\n\t\treturn 'motiongpuBlitVertex';\n\t}\n\n\tprotected getFragmentEntryPoint(): string {\n\t\treturn 'motiongpuBlitFragment';\n\t}\n}\n"],"mappings":";;AAEA,IAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmC/B,IAAa,WAAb,cAA8B,eAAe;CAC5C,aAA+B;AAC9B,SAAO;;CAGR,YAAY,UAA2B,EAAE,EAAE;AAC1C,QAAM,QAAQ;;CAGf,sBAAwC;AACvC,SAAO;;CAGR,wBAA0C;AACzC,SAAO"}

package/dist/passes/ComputePass.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Dispatch context provided to dynamic dispatch callbacks.
+ */
+export interface ComputeDispatchContext {
+    width: number;
+    height: number;
+    time: number;
+    delta: number;
+    workgroupSize: [number, number, number];
+}
+/**
+ * Options for constructing a `ComputePass`.
+ */
+export interface ComputePassOptions {
+    /**
+     * Compute shader WGSL source code.
+     * Must declare `@compute @workgroup_size(...) fn compute(@builtin(global_invocation_id) ...)`.
+     */
+    compute: string;
+    /**
+     * Dispatch workgroup counts.
+     * - Static tuple: `[x]`, `[x, y]`, or `[x, y, z]`
+     * - `'auto'`: derived from canvas size / workgroup size
+     * - Function: dynamic dispatch based on frame context
+     */
+    dispatch?: [number, number?, number?] | 'auto' | ((ctx: ComputeDispatchContext) => [number, number, number]);
+    /**
+     * Enables/disables this compute pass.
+     */
+    enabled?: boolean;
+}
+/**
+ * Compute pass class used within the render graph.
+ *
+ * Validates compute shader contract, parses workgroup size,
+ * and resolves dispatch dimensions. Does **not** manage GPU resources
+ * (that responsibility belongs to the renderer).
+ */
+export declare class ComputePass {
+    /**
+     * Enables/disables this pass without removing it from graph.
+     */
+    enabled: boolean;
+    /**
+     * Discriminant flag for render graph to identify compute passes.
+     */
+    readonly isCompute: true;
+    private compute;
+    private workgroupSize;
+    private dispatch;
+    constructor(options: ComputePassOptions);
+    /**
+     * Replaces current compute shader and updates workgroup size.
+     *
+     * @param compute - New compute shader WGSL source.
+     * @throws {Error} When shader does not match the compute contract.
+     */
+    setCompute(compute: string): void;
+    /**
+     * Updates dispatch strategy.
+     */
+    setDispatch(dispatch: ComputePassOptions['dispatch']): void;
+    /**
+     * Returns current compute shader source.
+     */
+    getCompute(): string;
+    /**
+     * Returns parsed workgroup size from current compute shader.
+     */
+    getWorkgroupSize(): [number, number, number];
+    /**
+     * Resolves dispatch workgroup counts for current frame.
+     *
+     * @param ctx - Dispatch context with canvas dimensions and timing.
+     * @returns Tuple [x, y, z] workgroup counts.
+     */
+    resolveDispatch(ctx: ComputeDispatchContext): [number, number, number];
+    /**
+     * Releases resources (no-op since GPU resource lifecycle is renderer-managed).
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=ComputePass.d.ts.map

package/dist/passes/ComputePass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComputePass.d.ts","sourceRoot":"","sources":["../../src/lib/passes/ComputePass.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EACN,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC1B,MAAM,GACN,CAAC,CAAC,GAAG,EAAE,sBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/D;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACvB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAG,IAAI,CAAU;IAEnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAiC;gBAErC,OAAO,EAAE,kBAAkB;IASvC;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOjC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,UAAU,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,gBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAI5C;;;;;OAKG;IACH,eAAe,CAAC,GAAG,EAAE,sBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAoBtE;;OAEG;IACH,OAAO,IAAI,IAAI;CAGf"}