@motion-core/motion-gpu 0.1.0

package/dist/core/render-targets.d.ts

@@ -0,0 +1,39 @@
+import type { RenderTargetDefinitionMap } from './types';
+/**
+ * Concrete render target configuration resolved for current canvas size.
+ */
+export interface ResolvedRenderTargetDefinition {
+    /**
+     * Render target key.
+     */
+    key: string;
+    /**
+     * Resolved width in pixels.
+     */
+    width: number;
+    /**
+     * Resolved height in pixels.
+     */
+    height: number;
+    /**
+     * Resolved format.
+     */
+    format: GPUTextureFormat;
+}
+/**
+ * Resolves all render target definitions for a specific canvas size.
+ *
+ * @param definitions - Declarative definitions.
+ * @param canvasWidth - Current canvas width in pixels.
+ * @param canvasHeight - Current canvas height in pixels.
+ * @param defaultFormat - Fallback texture format.
+ * @returns Sorted concrete render target definitions.
+ */
+export declare function resolveRenderTargetDefinitions(definitions: RenderTargetDefinitionMap | undefined, canvasWidth: number, canvasHeight: number, defaultFormat: GPUTextureFormat): ResolvedRenderTargetDefinition[];
+/**
+ * Builds a deterministic signature used to detect render target topology changes.
+ *
+ * @param resolvedDefinitions - Concrete target definitions.
+ * @returns Stable signature string.
+ */
+export declare function buildRenderTargetSignature(resolvedDefinitions: ResolvedRenderTargetDefinition[]): string;

package/dist/core/render-targets.js

@@ -0,0 +1,63 @@
+import { assertUniformName } from './uniforms';
+/**
+ * Asserts positive finite numeric input for render target options.
+ */
+function assertPositiveFinite(name, value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`${name} must be a finite number greater than 0`);
+    }
+}
+/**
+ * Resolves a render target dimension from explicit value or scaled canvas size.
+ */
+function resolveDimension(explicitValue, canvasDimension, scale) {
+    if (explicitValue !== undefined) {
+        assertPositiveFinite('RenderTarget dimension', explicitValue);
+        return Math.max(1, Math.floor(explicitValue));
+    }
+    return Math.max(1, Math.floor(canvasDimension * scale));
+}
+/**
+ * Resolves all render target definitions for a specific canvas size.
+ *
+ * @param definitions - Declarative definitions.
+ * @param canvasWidth - Current canvas width in pixels.
+ * @param canvasHeight - Current canvas height in pixels.
+ * @param defaultFormat - Fallback texture format.
+ * @returns Sorted concrete render target definitions.
+ */
+export function resolveRenderTargetDefinitions(definitions, canvasWidth, canvasHeight, defaultFormat) {
+    if (!definitions) {
+        return [];
+    }
+    const keys = Object.keys(definitions).sort();
+    const resolved = [];
+    for (const key of keys) {
+        assertUniformName(key);
+        const definition = definitions[key];
+        const scale = definition?.scale ?? 1;
+        assertPositiveFinite('RenderTarget scale', scale);
+        const width = resolveDimension(definition?.width, canvasWidth, scale);
+        const height = resolveDimension(definition?.height, canvasHeight, scale);
+        resolved.push({
+            key,
+            width,
+            height,
+            format: definition?.format ?? defaultFormat
+        });
+    }
+    return resolved;
+}
+/**
+ * Builds a deterministic signature used to detect render target topology changes.
+ *
+ * @param resolvedDefinitions - Concrete target definitions.
+ * @returns Stable signature string.
+ */
+export function buildRenderTargetSignature(resolvedDefinitions) {
+    return resolvedDefinitions
+        .map((definition) => {
+        return `${definition.key}:${definition.format}:${definition.width}x${definition.height}`;
+    })
+        .join('|');
+}

package/dist/core/renderer.d.ts

@@ -0,0 +1,9 @@
+import type { Renderer, RendererOptions } from './types';
+/**
+ * Creates the WebGPU renderer used by `FragCanvas`.
+ *
+ * @param options - Renderer creation options resolved from material/context state.
+ * @returns Renderer instance with `render` and `destroy`.
+ * @throws {Error} On WebGPU unavailability, shader compilation issues, or runtime setup failures.
+ */
+export declare function createRenderer(options: RendererOptions): Promise<Renderer>;