@vysmo/transitions 0.1.0 → 0.2.0

package/README.md

@@ -46,6 +46,40 @@ animate({
 
 `runner.render()` is one draw call per frame, regardless of the transition.
 
+### With URL strings (no DOM Image needed)
+
+`Runner.render()` is synchronous (frame-rate friendly), so URL inputs need
+a one-time pre-load up front. `runner.preload([…urls])` fetches + decodes
++ uploads each URL exactly once; subsequent renders use the cached GPU
+texture. Concurrent / repeat `preload` calls dedupe.
+
+```ts
+import { Runner, paintBleed } from "@vysmo/transitions";
+import { animate } from "@vysmo/animations";
+
+const canvas = document.querySelector<HTMLCanvasElement>("canvas")!;
+const runner = new Runner({ canvas });
+
+const fromUrl = "/photo-a.jpg";
+const toUrl = "/photo-b.jpg";
+await runner.preload([fromUrl, toUrl]);
+
+animate({
+  from: 0,
+  to: 1,
+  duration: 1200,
+  onUpdate: (p) => runner.render(paintBleed, {
+    from: fromUrl,
+    to: toUrl,
+    progress: p,
+  }),
+});
+```
+
+Cross-origin URLs need the right CORS headers (same as any WebGL texture
+source). For Next.js apps, see the
+[Vysmo + Next.js guide](https://vysmo.com/guides/nextjs).
+
 ## Tree-shake by what you import
 
 Every transition is its own module. Import only the ones you ship:

package/dist/runner/runner.d.ts

@@ -1,3 +1,4 @@
+import type { TextureCacheOptions, TextureSource } from "@vysmo/gl-core";
 import type { RenderArgs, Transition, UniformParams } from "../types.js";
 export interface RunnerOptions {
     /** Render target. `OffscreenCanvas` works in workers; `HTMLCanvasElement` on the main thread. */
@@ -20,6 +21,15 @@ export interface RunnerOptions {
      * `webglcontextrestored` event. After this, `render()` works again.
      */
     onContextRestored?: () => void;
+    /**
+     * Options forwarded to the internal `TextureCache`. Most callers can
+     * ignore this; pass `{ maxUrlEntries: N }` if you're driving the
+     * runner from a lazy-loading consumer (e.g. a slideshow with hundreds
+     * of slides) to keep GPU memory bounded — least-recently-used URL
+     * textures are evicted when the cache size exceeds N. DOM-source
+     * textures are not subject to LRU.
+     */
+    textureCache?: TextureCacheOptions;
 }
 /**
  * The single object that owns a WebGL2 context, compiles transition
@@ -44,6 +54,7 @@ export declare class Runner {
     readonly gl: WebGL2RenderingContext;
     private canvas;
     private textures;
+    private readonly textureCacheOptions;
     private programs;
     private vao;
     private defaultDisplacement;
@@ -80,6 +91,39 @@ export declare class Runner {
      * @throws Error if the runner is disposed or the WebGL context is lost.
      * @throws Error if shader compilation or program linking fails.
      */
+    /**
+     * Pre-load URL string sources so that subsequent synchronous
+     * `render()` calls can reference them without throwing. DOM-source
+     * inputs (`HTMLImageElement`, canvas, video, etc.) are ignored — they
+     * carry their own pixel data and don't need to be fetched.
+     *
+     * Typical use:
+     *
+     *     const fromUrl = "/photo-a.jpg";
+     *     const toUrl = "/photo-b.jpg";
+     *     await runner.preload([fromUrl, toUrl]);
+     *     animate({
+     *       ...,
+     *       onUpdate: (p) => runner.render(crossZoom, {
+     *         from: fromUrl, to: toUrl, progress: p,
+     *       }),
+     *     });
+     *
+     * Resolves once every URL has been fetched, decoded, and uploaded.
+     * Calls for the same URL are deduplicated (concurrent and repeat
+     * calls share one in-flight load).
+     *
+     * @throws Error if any source fails to fetch / decode (rejected
+     *               promise from the underlying `TextureCache.resolveAsync`).
+     */
+    preload(sources: ReadonlyArray<TextureSource | string>): Promise<void>;
+    /**
+     * Internal: resolve a single render-args source to its GL texture.
+     * Strings go through the synchronous URL cache; if the URL hasn't
+     * been pre-loaded via `preload()`, throws with a clear pointer at
+     * the fix.
+     */
+    private resolveForRender;
     render<P extends UniformParams>(transition: Transition<P>, args: RenderArgs<P>): void;
     private renderFullscreen;
     private renderMesh;

package/dist/runner/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EAEd,MAAM,aAAa,CAAC;AAmCrB,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAC5C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,EAAE,EAAE,sBAAsB,CAAC;IACpC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAgE;IAChF,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,mBAAmB,CAAe;IAC1C,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,eAAe,CAAe;IAEtC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IACF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAWpC;gBAEU,OAAO,EAAE,aAAa;IAoClC,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,kBAAkB;IAuB1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,CAAC,SAAS,aAAa,EAC5B,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAClB,IAAI;IA8EP,OAAO,CAAC,gBAAgB;IAoDxB,OAAO,CAAC,UAAU;IAsClB;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;;;;;;OASG;IACH,OAAO,IAAI,IAAI;IAkBf,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,UAAU;CAkBnB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EAEd,MAAM,aAAa,CAAC;AAmCrB,MAAM,WAAW,aAAa;IAC5B,iGAAiG;IACjG,MAAM,EAAE,iBAAiB,GAAG,eAAe,CAAC;IAC5C;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,sBAAsB,CAAC;IAC3C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC/B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,MAAM;IACjB,QAAQ,CAAC,EAAE,EAAE,sBAAsB,CAAC;IACpC,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,OAAO,CAAC,QAAQ,CAAgE;IAChF,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,mBAAmB,CAAe;IAC1C,OAAO,CAAC,kBAAkB,CAAe;IACzC,OAAO,CAAC,eAAe,CAAe;IAEtC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2B;IACzD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA2B;IAC7D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAKhC;IACF,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAWpC;gBAEU,OAAO,EAAE,aAAa;IAqClC,OAAO,CAAC,yBAAyB;IAMjC,OAAO,CAAC,wBAAwB;IAOhC,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,kBAAkB;IAuB1B;;;;;;;;;;;;;;;;;;OAkBG;IACH;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,aAAa,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5E;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IAkBxB,MAAM,CAAC,CAAC,SAAS,aAAa,EAC5B,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAClB,IAAI;IA8EP,OAAO,CAAC,gBAAgB;IAoDxB,OAAO,CAAC,UAAU;IAsClB;;;OAGG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;;;;;;;;OASG;IACH,OAAO,IAAI,IAAI;IAkBf,OAAO,CAAC,YAAY;IAuCpB,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,UAAU;CAkBnB"}

package/dist/runner/runner.js

@@ -32,6 +32,7 @@ export class Runner {
     gl;
     canvas;
     textures;
+    textureCacheOptions;
     programs = new WeakMap();
     vao;
     defaultDisplacement;
@@ -54,7 +55,7 @@ export class Runner {
         const vao = this.gl.createVertexArray();
         if (vao)
             this.vao = vao;
-        this.textures = new TextureCache(this.gl);
+        this.textures = new TextureCache(this.gl, this.textureCacheOptions);
         this.defaultDisplacement = this.createDefaultDisplacement();
         this.defaultEnvironment = this.createDefaultEnvironment();
         this.defaultPrevious = this.createDefaultPrevious();
@@ -77,7 +78,8 @@ export class Runner {
             throw new Error("WebGL2 is not available. This environment does not support the transitions library.");
         }
         this.gl = gl;
-        this.textures = new TextureCache(gl);
+        this.textureCacheOptions = options.textureCache;
+        this.textures = new TextureCache(gl, options.textureCache);
         this.fbPool = new FramebufferPool(gl);
         const vao = gl.createVertexArray();
         if (!vao)
@@ -141,6 +143,54 @@ export class Runner {
      * @throws Error if the runner is disposed or the WebGL context is lost.
      * @throws Error if shader compilation or program linking fails.
      */
+    /**
+     * Pre-load URL string sources so that subsequent synchronous
+     * `render()` calls can reference them without throwing. DOM-source
+     * inputs (`HTMLImageElement`, canvas, video, etc.) are ignored — they
+     * carry their own pixel data and don't need to be fetched.
+     *
+     * Typical use:
+     *
+     *     const fromUrl = "/photo-a.jpg";
+     *     const toUrl = "/photo-b.jpg";
+     *     await runner.preload([fromUrl, toUrl]);
+     *     animate({
+     *       ...,
+     *       onUpdate: (p) => runner.render(crossZoom, {
+     *         from: fromUrl, to: toUrl, progress: p,
+     *       }),
+     *     });
+     *
+     * Resolves once every URL has been fetched, decoded, and uploaded.
+     * Calls for the same URL are deduplicated (concurrent and repeat
+     * calls share one in-flight load).
+     *
+     * @throws Error if any source fails to fetch / decode (rejected
+     *               promise from the underlying `TextureCache.resolveAsync`).
+     */
+    async preload(sources) {
+        await Promise.all(sources
+            .filter((s) => typeof s === "string")
+            .map((url) => this.textures.resolveAsync(url)));
+    }
+    /**
+     * Internal: resolve a single render-args source to its GL texture.
+     * Strings go through the synchronous URL cache; if the URL hasn't
+     * been pre-loaded via `preload()`, throws with a clear pointer at
+     * the fix.
+     */
+    resolveForRender(source, role) {
+        if (typeof source !== "string") {
+            return this.textures.resolve(source);
+        }
+        const cached = this.textures.getUrlTexture(source);
+        if (!cached) {
+            throw new Error(`Runner.render(): "${role}" URL is not loaded: ${source}. ` +
+                `Call runner.preload(["${source}"]) before render() (URL inputs must be ` +
+                `fetched + decoded + uploaded before render(), which is synchronous).`);
+        }
+        return cached;
+    }
     render(transition, args) {
         if (this.disposed) {
             throw new Error("Runner has been disposed. Create a new Runner to render.");
@@ -163,13 +213,13 @@ export class Runner {
         // gl.bindTexture() against whichever unit is currently active (to
         // upload pixels), so if we interleave resolves with activeTexture()
         // calls, each resolve clobbers the most recently bound unit.
-        const fromTex = this.textures.resolve(args.from);
-        const toTex = this.textures.resolve(args.to);
+        const fromTex = this.resolveForRender(args.from, "from");
+        const toTex = this.resolveForRender(args.to, "to");
         const displacementTex = args.displacement
-            ? this.textures.resolve(args.displacement)
+            ? this.resolveForRender(args.displacement, "displacement")
             : this.defaultDisplacement;
         const environmentTex = args.environment
-            ? this.textures.resolve(args.environment)
+            ? this.resolveForRender(args.environment, "environment")
             : this.defaultEnvironment;
         gl.activeTexture(gl.TEXTURE0);
         gl.bindTexture(gl.TEXTURE_2D, fromTex);

package/dist/runner/runner.js.map

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

package/dist/types.d.ts

@@ -52,8 +52,17 @@ export interface Transition<P extends UniformParams = UniformParams> {
     mesh?: MeshGeometry;
 }
 export interface RenderArgs<P extends UniformParams> {
-    from: TextureSource;
-    to: TextureSource;
+    /**
+     * Source image. Accepts any `TextureSource` (`HTMLImageElement`,
+     * `HTMLCanvasElement`, `HTMLVideoElement`, `ImageBitmap`,
+     * `OffscreenCanvas`, raw `WebGLTexture`) **or** a URL string. URL
+     * inputs must be pre-loaded via `runner.preload([url])` before
+     * `render()` is called — `render()` itself is synchronous and will
+     * throw if asked to draw an un-preloaded URL.
+     */
+    from: TextureSource | string;
+    /** Target image. Same input types as `from`; see `from` for URL pre-loading rules. */
+    to: TextureSource | string;
     progress: number;
     params?: Partial<P>;
     /**
@@ -64,15 +73,19 @@ export interface RenderArgs<P extends UniformParams> {
      * negatively. If omitted, the runner binds a default 1×1 mid-gray
      * texture so displacement-using transitions degrade to no-op rather
      * than failing.
+     *
+     * Accepts URL strings on the same pre-load contract as `from` / `to`.
      */
-    displacement?: TextureSource;
+    displacement?: TextureSource | string;
     /**
      * Optional environment-map texture. Transitions that read it via the
      * getEnvironment(uv) shader helper (e.g. liquid-chrome with reflection
      * enabled) use it to fake reflections off metallic / glass surfaces.
      * If omitted, the runner binds a default 1×1 mid-gray texture so
      * environment-using transitions degrade to a neutral no-op.
+     *
+     * Accepts URL strings on the same pre-load contract as `from` / `to`.
      */
-    environment?: TextureSource;
+    environment?: TextureSource | string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,KAAK,EACN,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC;IACZ;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,aAAa;IACjD,IAAI,EAAE,aAAa,CAAC;IACpB,EAAE,EAAE,aAAa,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,aAAa,EACb,KAAK,EACN,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,YAAY,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,aAAa,GAAG,aAAa;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC;IACZ;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,aAAa;IACjD;;;;;;;OAOG;IACH,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC;IAC7B,sFAAsF;IACtF,EAAE,EAAE,aAAa,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;IACtC;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,aAAa,GAAG,MAAM,CAAC;CACtC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vysmo/transitions",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "60 WebGL2 transition shaders, defined as plain data. Mesh-based, tree-shakable to the byte, endpoint-correct by construction. Drives canvas, image, and video sources via one Runner.",
   "license": "MIT",
   "keywords": [
@@ -35,7 +35,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@vysmo/gl-core": "0.1.0"
+    "@vysmo/gl-core": "0.2.0"
   },
   "devDependencies": {
     "@vitest/browser": "^3.2.4",

package/src/runner/__tests__/url-inputs.test.ts

@@ -0,0 +1,137 @@
+import { beforeEach, describe, expect, it } from "vitest";
+import { Runner, paintBleed } from "../../index.js";
+
+const SIZE = 16;
+
+function makeSolid(r: number, g: number, b: number): HTMLCanvasElement {
+  const canvas = document.createElement("canvas");
+  canvas.width = SIZE;
+  canvas.height = SIZE;
+  const ctx = canvas.getContext("2d");
+  if (!ctx) throw new Error("2D context unavailable");
+  ctx.fillStyle = `rgb(${r}, ${g}, ${b})`;
+  ctx.fillRect(0, 0, SIZE, SIZE);
+  return canvas;
+}
+
+async function blobUrl(color: string): Promise<string> {
+  const canvas = makeSolid(
+    parseInt(color.slice(1, 3), 16),
+    parseInt(color.slice(3, 5), 16),
+    parseInt(color.slice(5, 7), 16),
+  );
+  const blob: Blob = await new Promise((resolve, reject) => {
+    canvas.toBlob((b) => (b ? resolve(b) : reject(new Error("toBlob failed"))));
+  });
+  return URL.createObjectURL(blob);
+}
+
+let canvas: HTMLCanvasElement;
+let runner: Runner;
+
+beforeEach(() => {
+  canvas = document.createElement("canvas");
+  canvas.width = SIZE;
+  canvas.height = SIZE;
+  runner = new Runner({ canvas });
+});
+
+describe("Runner URL inputs", () => {
+  it("renders a transition after preloading from/to URLs", async () => {
+    const fromUrl = await blobUrl("#ff0000");
+    const toUrl = await blobUrl("#0000ff");
+
+    await runner.preload([fromUrl, toUrl]);
+
+    // Should not throw — the URLs are pre-loaded.
+    expect(() =>
+      runner.render(paintBleed, {
+        from: fromUrl,
+        to: toUrl,
+        progress: 0.5,
+      }),
+    ).not.toThrow();
+  });
+
+  it("throws a helpful error when rendering with an un-preloaded URL", async () => {
+    const fromUrl = await blobUrl("#ff0000");
+    const toUrl = await blobUrl("#0000ff");
+    // Only preload `from`; `to` remains unloaded.
+    await runner.preload([fromUrl]);
+
+    expect(() =>
+      runner.render(paintBleed, {
+        from: fromUrl,
+        to: toUrl,
+        progress: 0.5,
+      }),
+    ).toThrow(/URL is not loaded/);
+  });
+
+  it("error message names the un-preloaded URL and the role (from/to)", async () => {
+    const fromUrl = await blobUrl("#00ff00");
+    const toUrl = await blobUrl("#ff00ff");
+    await runner.preload([toUrl]); // only `to` preloaded; `from` is missing
+
+    try {
+      runner.render(paintBleed, {
+        from: fromUrl,
+        to: toUrl,
+        progress: 0.5,
+      });
+      throw new Error("should have thrown");
+    } catch (err) {
+      expect(err).toBeInstanceOf(Error);
+      const message = (err as Error).message;
+      expect(message).toContain('"from"');
+      expect(message).toContain(fromUrl);
+      expect(message).toContain("preload");
+    }
+  });
+
+  it("preload() ignores DOM-source inputs (they don't need pre-loading)", async () => {
+    // Passing a mix of URLs and DOM sources to preload should resolve
+    // cleanly. DOM sources are filtered out before the async work.
+    const fromUrl = await blobUrl("#ff0000");
+    const toCanvas = makeSolid(0, 0, 255);
+    await expect(
+      runner.preload([fromUrl, toCanvas]),
+    ).resolves.toBeUndefined();
+    // And the subsequent render with both should work.
+    expect(() =>
+      runner.render(paintBleed, {
+        from: fromUrl,
+        to: toCanvas,
+        progress: 0.3,
+      }),
+    ).not.toThrow();
+  });
+
+  it("can render with mixed source types (URL from, canvas to)", async () => {
+    const fromUrl = await blobUrl("#ff0000");
+    const toCanvas = makeSolid(0, 0, 255);
+    await runner.preload([fromUrl]);
+    expect(() =>
+      runner.render(paintBleed, {
+        from: fromUrl,
+        to: toCanvas,
+        progress: 0.5,
+      }),
+    ).not.toThrow();
+  });
+
+  it("preload() deduplicates repeated URLs (no double-fetch)", async () => {
+    // Call preload twice with the same URL — should resolve fine, and
+    // the underlying TextureCache dedup means only one fetch happens.
+    const url = await blobUrl("#abcdef");
+    await runner.preload([url]);
+    await runner.preload([url]); // hit cache
+    expect(() =>
+      runner.render(paintBleed, {
+        from: url,
+        to: url,
+        progress: 0.5,
+      }),
+    ).not.toThrow();
+  });
+});

package/src/runner/runner.ts

@@ -1,4 +1,5 @@
 import { FramebufferPool, TextureCache } from "@vysmo/gl-core";
+import type { TextureCacheOptions, TextureSource } from "@vysmo/gl-core";
 import type {
   RenderArgs,
   Transition,
@@ -60,6 +61,15 @@ export interface RunnerOptions {
    * `webglcontextrestored` event. After this, `render()` works again.
    */
   onContextRestored?: () => void;
+  /**
+   * Options forwarded to the internal `TextureCache`. Most callers can
+   * ignore this; pass `{ maxUrlEntries: N }` if you're driving the
+   * runner from a lazy-loading consumer (e.g. a slideshow with hundreds
+   * of slides) to keep GPU memory bounded — least-recently-used URL
+   * textures are evicted when the cache size exceeds N. DOM-source
+   * textures are not subject to LRU.
+   */
+  textureCache?: TextureCacheOptions;
 }
 
 /**
@@ -85,6 +95,7 @@ export class Runner {
   readonly gl: WebGL2RenderingContext;
   private canvas: HTMLCanvasElement | OffscreenCanvas;
   private textures: TextureCache;
+  private readonly textureCacheOptions: TextureCacheOptions | undefined;
   private programs = new WeakMap<Transition<UniformParams>, CompiledTransition>();
   private vao: WebGLVertexArrayObject;
   private defaultDisplacement: WebGLTexture;
@@ -106,7 +117,7 @@ export class Runner {
     this.contextLost = false;
     const vao = this.gl.createVertexArray();
     if (vao) this.vao = vao;
-    this.textures = new TextureCache(this.gl);
+    this.textures = new TextureCache(this.gl, this.textureCacheOptions);
     this.defaultDisplacement = this.createDefaultDisplacement();
     this.defaultEnvironment = this.createDefaultEnvironment();
     this.defaultPrevious = this.createDefaultPrevious();
@@ -134,7 +145,8 @@ export class Runner {
       );
     }
     this.gl = gl;
-    this.textures = new TextureCache(gl);
+    this.textureCacheOptions = options.textureCache;
+    this.textures = new TextureCache(gl, options.textureCache);
     this.fbPool = new FramebufferPool(gl);
 
     const vao = gl.createVertexArray();
@@ -214,6 +226,63 @@ export class Runner {
    * @throws Error if the runner is disposed or the WebGL context is lost.
    * @throws Error if shader compilation or program linking fails.
    */
+  /**
+   * Pre-load URL string sources so that subsequent synchronous
+   * `render()` calls can reference them without throwing. DOM-source
+   * inputs (`HTMLImageElement`, canvas, video, etc.) are ignored — they
+   * carry their own pixel data and don't need to be fetched.
+   *
+   * Typical use:
+   *
+   *     const fromUrl = "/photo-a.jpg";
+   *     const toUrl = "/photo-b.jpg";
+   *     await runner.preload([fromUrl, toUrl]);
+   *     animate({
+   *       ...,
+   *       onUpdate: (p) => runner.render(crossZoom, {
+   *         from: fromUrl, to: toUrl, progress: p,
+   *       }),
+   *     });
+   *
+   * Resolves once every URL has been fetched, decoded, and uploaded.
+   * Calls for the same URL are deduplicated (concurrent and repeat
+   * calls share one in-flight load).
+   *
+   * @throws Error if any source fails to fetch / decode (rejected
+   *               promise from the underlying `TextureCache.resolveAsync`).
+   */
+  async preload(sources: ReadonlyArray<TextureSource | string>): Promise<void> {
+    await Promise.all(
+      sources
+        .filter((s): s is string => typeof s === "string")
+        .map((url) => this.textures.resolveAsync(url)),
+    );
+  }
+
+  /**
+   * Internal: resolve a single render-args source to its GL texture.
+   * Strings go through the synchronous URL cache; if the URL hasn't
+   * been pre-loaded via `preload()`, throws with a clear pointer at
+   * the fix.
+   */
+  private resolveForRender(
+    source: TextureSource | string,
+    role: string,
+  ): WebGLTexture {
+    if (typeof source !== "string") {
+      return this.textures.resolve(source);
+    }
+    const cached = this.textures.getUrlTexture(source);
+    if (!cached) {
+      throw new Error(
+        `Runner.render(): "${role}" URL is not loaded: ${source}. ` +
+          `Call runner.preload(["${source}"]) before render() (URL inputs must be ` +
+          `fetched + decoded + uploaded before render(), which is synchronous).`,
+      );
+    }
+    return cached;
+  }
+
   render<P extends UniformParams>(
     transition: Transition<P>,
     args: RenderArgs<P>,
@@ -246,13 +315,13 @@ export class Runner {
     // gl.bindTexture() against whichever unit is currently active (to
     // upload pixels), so if we interleave resolves with activeTexture()
     // calls, each resolve clobbers the most recently bound unit.
-    const fromTex = this.textures.resolve(args.from);
-    const toTex = this.textures.resolve(args.to);
+    const fromTex = this.resolveForRender(args.from, "from");
+    const toTex = this.resolveForRender(args.to, "to");
     const displacementTex = args.displacement
-      ? this.textures.resolve(args.displacement)
+      ? this.resolveForRender(args.displacement, "displacement")
       : this.defaultDisplacement;
     const environmentTex = args.environment
-      ? this.textures.resolve(args.environment)
+      ? this.resolveForRender(args.environment, "environment")
       : this.defaultEnvironment;
 
     gl.activeTexture(gl.TEXTURE0);

package/src/types.ts

@@ -62,8 +62,17 @@ export interface Transition<P extends UniformParams = UniformParams> {
 }
 
 export interface RenderArgs<P extends UniformParams> {
-  from: TextureSource;
-  to: TextureSource;
+  /**
+   * Source image. Accepts any `TextureSource` (`HTMLImageElement`,
+   * `HTMLCanvasElement`, `HTMLVideoElement`, `ImageBitmap`,
+   * `OffscreenCanvas`, raw `WebGLTexture`) **or** a URL string. URL
+   * inputs must be pre-loaded via `runner.preload([url])` before
+   * `render()` is called — `render()` itself is synchronous and will
+   * throw if asked to draw an un-preloaded URL.
+   */
+  from: TextureSource | string;
+  /** Target image. Same input types as `from`; see `from` for URL pre-loading rules. */
+  to: TextureSource | string;
   progress: number;
   params?: Partial<P>;
   /**
@@ -74,14 +83,18 @@ export interface RenderArgs<P extends UniformParams> {
    * negatively. If omitted, the runner binds a default 1×1 mid-gray
    * texture so displacement-using transitions degrade to no-op rather
    * than failing.
+   *
+   * Accepts URL strings on the same pre-load contract as `from` / `to`.
    */
-  displacement?: TextureSource;
+  displacement?: TextureSource | string;
   /**
    * Optional environment-map texture. Transitions that read it via the
    * getEnvironment(uv) shader helper (e.g. liquid-chrome with reflection
    * enabled) use it to fake reflections off metallic / glass surfaces.
    * If omitted, the runner binds a default 1×1 mid-gray texture so
    * environment-using transitions degrade to a neutral no-op.
+   *
+   * Accepts URL strings on the same pre-load contract as `from` / `to`.
    */
-  environment?: TextureSource;
+  environment?: TextureSource | string;
 }