Editor hardening, test baseline, CI validation, export fixes, and blob-tracking groundwork

- fix pre-existing biome lint errors (4 errors across app + package)
- add first test suite: 75 tests over .lab parsing, parameter schema,
  timeline evaluation, composition math, blob tracker, inner effects
- CI now lints, typechecks and tests the editor app, not just the package
- .lab import: zod schema validation, consent prompt before imported
  custom-shader code runs, SVG raster resolution capped at 8192
- lazy-load export dialog and video muxers (-99.9 KB first-load JS)
- close the video encoder on failed/cancelled exports; 30s timeout on
  stalled video texture loads
- onRuntimeError no longer fires with null after successful init
- renderer dedup: drift inventory + consolidation design (plans/006-artifacts)
- drop localeCompare from per-frame parameter signatures
- blob-tracking foundation: pure CPU tracker + inner-effects modules (unwired)

Includes patch changesets for the two package changes.

Author: git-chad

.changeset/fix-onruntimeerror-null.md

@@ -0,0 +1,5 @@
+---
+"@basementstudio/shader-lab": patch
+---
+
+`onRuntimeError` on `<ShaderLabComposition>` is no longer called with `null` after every successful renderer initialization. It now only fires with `null` once a previously reported error has been resolved, and consecutive identical messages are not repeated. Consumers that surfaced the message without a null check no longer show a false error state.

.changeset/lint-cleanup.md

@@ -0,0 +1,5 @@
+---
+"@basementstudio/shader-lab": patch
+---
+
+Lint cleanup: convert type-only `three/webgpu` imports to `import type`, remove an unused suppression comment, and simplify a guard expression in the fluid runtime. No behavior changes.

.github/workflows/ci.yml

@@ -32,6 +32,15 @@ jobs:
       - name: Build package
         run: bun run --cwd packages/shader-lab-react build
 
+      - name: Lint app
+        run: bun run lint
+
+      - name: Type check app
+        run: bun run typecheck:tsc
+
+      - name: Test
+        run: bun test
+
       - name: Ensure changeset exists for PR changes
         if: github.event_name == 'pull_request'
         run: bunx changeset status --since=origin/${{ github.base_ref }}

README.md

@@ -90,11 +90,21 @@ Handle runtime errors:
 <ShaderLabComposition
   config={config}
   onRuntimeError={(message) => {
-    console.error(message)
+    if (message) {
+      console.error(message)
+    } else {
+      console.info("Shader Lab runtime error resolved.")
+    }
   }}
 />
 ```
 
+`onRuntimeError` is called with a string message when a runtime error occurs
+(renderer initialization failure, shader compilation error, missing WebGPU
+support). After an error has been reported, it is called once with `null` when
+the error is resolved so error UIs can recover. It is never called with `null`
+before an error has been reported.
+
 ## 2. Use a Composition as a Texture
 
 `useShaderLab` can manage the runtime and return a ready-to-use `THREE.CanvasTexture`.

packages/shader-lab-react/README.md

@@ -90,11 +90,21 @@ Handle runtime errors:
 <ShaderLabComposition
   config={config}
   onRuntimeError={(message) => {
-    console.error(message)
+    if (message) {
+      console.error(message)
+    } else {
+      console.info("Shader Lab runtime error resolved.")
+    }
   }}
 />
 ```
 
+`onRuntimeError` is called with a string message when a runtime error occurs
+(renderer initialization failure, shader compilation error, missing WebGPU
+support). After an error has been reported, it is called once with `null` when
+the error is resolved so error UIs can recover. It is never called with `null`
+before an error has been reported.
+
 ## 2. Use a Composition as a Texture
 
 `useShaderLab` can manage the runtime and return a ready-to-use `THREE.CanvasTexture`.

packages/shader-lab-react/src/ambient/three-tsl.d.ts

@@ -92,7 +92,6 @@ declare module "three/tsl" {
   export function cross(left: unknown, right: unknown): TSLNode
   export function div(left: unknown, right: unknown): TSLNode
   export function dot(left: unknown, right: unknown): TSLNode
-  // biome-ignore lint/suspicious/noExplicitAny: TSL Fn accepts both positional and destructured params
   export function Fn(
     fn: ShaderNodeFn | ((...args: never[]) => unknown),
     layout?: unknown

packages/shader-lab-react/src/fluid/runtime.ts

@@ -351,9 +351,14 @@ export class ShaderLabFluidRuntime {
     color?: ShaderLabFluidSplatColor
   ): void {
     if (
-      !(this.readyState && this.renderer && this.velocity && this.density) ||
-      !this.splatMaterial ||
-      !this.splatTargetNode
+      !(
+        this.readyState &&
+        this.renderer &&
+        this.velocity &&
+        this.density &&
+        this.splatMaterial &&
+        this.splatTargetNode
+      )
     ) {
       return
     }

packages/shader-lab-react/src/renderer/chromatic-aberration-pass.ts

@@ -11,7 +11,7 @@ import {
   vec2,
   vec4,
 } from "three/tsl"
-import * as THREE from "three/webgpu"
+import type * as THREE from "three/webgpu"
 import type { ShaderLabLayerConfig } from "../types"
 import { createPipelinePlaceholder, PassNode } from "./pass-node"
 

packages/shader-lab-react/src/renderer/directional-blur-pass.ts

@@ -1,4 +1,4 @@
-import * as THREE from "three/webgpu"
+import type * as THREE from "three/webgpu"
 import {
   cos,
   float,

packages/shader-lab-react/src/renderer/displacement-map-pass.ts

@@ -8,7 +8,7 @@ import {
   vec2,
   vec4,
 } from "three/tsl"
-import * as THREE from "three/webgpu"
+import type * as THREE from "three/webgpu"
 import type { ShaderLabLayerConfig } from "../types"
 import { createPipelinePlaceholder, PassNode } from "./pass-node"