@vysmo/transitions 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"gl.d.ts","sourceRoot":"","sources":["../../src/runner/gl.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,IAAI,aAAa,EACzC,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,sBAAsB,sSAelC,CAAC;AAEF,eAAO,MAAM,mBAAmB,w9BA6B/B,CAAC;AAEF,eAAO,MAAM,mBAAmB,yDAI/B,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/dist/runner/gl.js

@@ -0,0 +1,59 @@
+export { FULLSCREEN_VERTEX_SHADER as VERTEX_SHADER, compileShader, linkProgram, buildProgram, paramKeyToUniformName, } from "@vysmo/gl-core";
+export const MESH_VERTEX_SHELL_HEAD = `#version 300 es
+precision highp float;
+uniform float uProgress;
+uniform vec2 uResolution;
+uniform int uPass;
+uniform int uPassCount;
+uniform int uInstances;
+in vec2 aPosition;
+in vec2 aUv;
+in float aOffset;
+in vec2 aCentroid;
+in vec3 aBary;
+in float aRandom;
+out vec2 vUv;
+
+`;
+export const FRAGMENT_SHELL_HEAD = `#version 300 es
+precision highp float;
+uniform sampler2D uFrom;
+uniform sampler2D uTo;
+uniform sampler2D uDisplacement;
+uniform sampler2D uEnvironment;
+uniform sampler2D uPrevious;
+uniform float uProgress;
+uniform vec2 uResolution;
+uniform int uPass;
+uniform int uPassCount;
+uniform int uInstances;
+in vec2 vUv;
+out vec4 fragColor;
+
+vec4 getFromColor(vec2 uv) { return texture(uFrom, uv); }
+vec4 getToColor(vec2 uv) { return texture(uTo, uv); }
+vec4 getDisplacement(vec2 uv) { return texture(uDisplacement, uv); }
+vec4 getEnvironment(vec2 uv) { return texture(uEnvironment, uv); }
+vec4 getPrevious(vec2 uv) { return texture(uPrevious, uv); }
+
+// Reflect out-of-range UVs back into [0,1] instead of clamping to edge.
+// Use this when a shader displaces UVs (warp, flow, etc.) and you want
+// the displaced regions to sample real interior content rather than
+// streaked edge texels.
+vec2 mirrorUv(vec2 uv) {
+  return abs(mod(uv + 1.0, 2.0) - 1.0);
+}
+
+`;
+export const FRAGMENT_SHELL_TAIL = `
+void main() {
+  fragColor = transition(vUv);
+}
+`;
+export function wrapFragmentShader(userBody) {
+    return FRAGMENT_SHELL_HEAD + userBody + FRAGMENT_SHELL_TAIL;
+}
+export function wrapMeshVertexShader(userBody) {
+    return MESH_VERTEX_SHELL_HEAD + userBody;
+}
+//# sourceMappingURL=gl.js.map

package/dist/runner/gl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gl.js","sourceRoot":"","sources":["../../src/runner/gl.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,IAAI,aAAa,EACzC,aAAa,EACb,WAAW,EACX,YAAY,EACZ,qBAAqB,GACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;CAerC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BlC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;CAIlC,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,mBAAmB,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,OAAO,sBAAsB,GAAG,QAAQ,CAAC;AAC3C,CAAC"}

package/dist/runner/mesh.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Subdivided-plane geometry for mesh-based transitions.
+ *
+ * Output is unindexed (6 vertices per quad, 3 per triangle). Attributes
+ * are organised so the two triangles that form a quad share per-face
+ * data — a quad is the natural "face" unit for flip/scatter/fly effects
+ * because a square quad is self-symmetric under 180° rotation, whereas
+ * a right-isoceles triangle is not.
+ *
+ * Layout per vertex:
+ *   aPosition  — per-vertex, clip space [-1, 1]
+ *   aUv        — per-vertex, texture space [0, 1]
+ *   aBary      — per-vertex, barycentric within its triangle
+ *   aCentroid  — per-QUAD centre, shared by all 6 verts of a quad
+ *   aOffset    — per-QUAD deterministic shuffle in [0, 1]
+ *   aRandom    — per-QUAD independent hash in [0, 1]
+ */
+export interface MeshBuffers {
+    vertexCount: number;
+    position: Float32Array;
+    uv: Float32Array;
+    offset: Float32Array;
+    centroid: Float32Array;
+    bary: Float32Array;
+    random: Float32Array;
+}
+export declare function buildSubdividedPlane(nx: number, ny: number): MeshBuffers;
+//# sourceMappingURL=mesh.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mesh.d.ts","sourceRoot":"","sources":["../../src/runner/mesh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;CACtB;AAgCD,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,CA6ExE"}

package/dist/runner/mesh.js

@@ -0,0 +1,96 @@
+const BARY_A = [1, 0, 0];
+const BARY_B = [0, 1, 0];
+const BARY_C = [0, 0, 1];
+function seededShuffledOffsets(n) {
+    const out = new Float32Array(n);
+    if (n === 0)
+        return out;
+    if (n === 1) {
+        out[0] = 0;
+        return out;
+    }
+    for (let i = 0; i < n; i++)
+        out[i] = i / (n - 1);
+    // Park-Miller LCG, seeded deterministically.
+    let seed = 1337;
+    for (let i = n - 1; i > 0; i--) {
+        seed = (seed * 48271) % 0x7fffffff;
+        const j = seed % (i + 1);
+        const tmp = out[i];
+        out[i] = out[j];
+        out[j] = tmp;
+    }
+    return out;
+}
+function hash01(k) {
+    // Shadertoy-style hash, deterministic per integer input.
+    const x = Math.sin(k * 12.9898 + 78.233) * 43758.5453;
+    return x - Math.floor(x);
+}
+export function buildSubdividedPlane(nx, ny) {
+    const gridX = Math.max(1, Math.floor(nx));
+    const gridY = Math.max(1, Math.floor(ny));
+    const quadCount = gridX * gridY;
+    const faceCount = quadCount * 2;
+    const vertexCount = faceCount * 3;
+    const position = new Float32Array(vertexCount * 2);
+    const uv = new Float32Array(vertexCount * 2);
+    const offset = new Float32Array(vertexCount);
+    const centroid = new Float32Array(vertexCount * 2);
+    const bary = new Float32Array(vertexCount * 3);
+    const random = new Float32Array(vertexCount);
+    const quadOffsets = seededShuffledOffsets(quadCount);
+    const dx = 2 / gridX;
+    const dy = 2 / gridY;
+    let v = 0;
+    for (let iy = 0; iy < gridY; iy++) {
+        for (let ix = 0; ix < gridX; ix++) {
+            const quadIdx = iy * gridX + ix;
+            const x0 = -1 + ix * dx;
+            const x1 = x0 + dx;
+            const y0 = -1 + iy * dy;
+            const y1 = y0 + dy;
+            const cx = (x0 + x1) * 0.5;
+            const cy = (y0 + y1) * 0.5;
+            const quadOffset = quadOffsets[quadIdx];
+            const quadRandom = hash01(quadIdx + 1);
+            // Two triangles per quad: (x0,y0)-(x1,y0)-(x0,y1) and (x1,y0)-(x1,y1)-(x0,y1).
+            const tris = [
+                [
+                    [x0, y0],
+                    [x1, y0],
+                    [x0, y1],
+                ],
+                [
+                    [x1, y0],
+                    [x1, y1],
+                    [x0, y1],
+                ],
+            ];
+            for (const tri of tris) {
+                const verts = [tri[0], tri[1], tri[2]];
+                const barys = [BARY_A, BARY_B, BARY_C];
+                for (let k = 0; k < 3; k++) {
+                    const vert = verts[k];
+                    const b = barys[k];
+                    const p0 = vert[0];
+                    const p1 = vert[1];
+                    position[v * 2] = p0;
+                    position[v * 2 + 1] = p1;
+                    uv[v * 2] = p0 * 0.5 + 0.5;
+                    uv[v * 2 + 1] = p1 * 0.5 + 0.5;
+                    offset[v] = quadOffset;
+                    centroid[v * 2] = cx;
+                    centroid[v * 2 + 1] = cy;
+                    bary[v * 3] = b[0];
+                    bary[v * 3 + 1] = b[1];
+                    bary[v * 3 + 2] = b[2];
+                    random[v] = quadRandom;
+                    v++;
+                }
+            }
+        }
+    }
+    return { vertexCount, position, uv, offset, centroid, bary, random };
+}
+//# sourceMappingURL=mesh.js.map

package/dist/runner/mesh.js.map

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

package/dist/runner/runner.d.ts

@@ -0,0 +1,107 @@
+import type { RenderArgs, Transition, UniformParams } from "../types.js";
+export interface RunnerOptions {
+    /** Render target. `OffscreenCanvas` works in workers; `HTMLCanvasElement` on the main thread. */
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    /**
+     * Forwarded to `canvas.getContext("webgl2", …)`. Defaults are
+     * `{ alpha: true, antialias: true, premultipliedAlpha: false,
+     * preserveDrawingBuffer: false }` — overrideable via this field.
+     */
+    contextAttributes?: WebGLContextAttributes;
+    /**
+     * Optional callback invoked when the WebGL context is lost. After this
+     * fires, `render()` throws until the context is restored — either
+     * automatically via the `webglcontextrestored` event (when the canvas
+     * is an `EventTarget`) or by re-creating the Runner.
+     */
+    onContextLost?: () => void;
+    /**
+     * Optional callback invoked once the runner has re-initialised after a
+     * `webglcontextrestored` event. After this, `render()` works again.
+     */
+    onContextRestored?: () => void;
+}
+/**
+ * The single object that owns a WebGL2 context, compiles transition
+ * shaders on first use, and renders frames. One Runner per canvas;
+ * one canvas per Runner.
+ *
+ * Usage shape:
+ *
+ *     const runner = new Runner({ canvas });
+ *     runner.render(crossZoom, { from: imgA, to: imgB, progress: 0.4 });
+ *     // … animate progress 0 → 1 with your driver of choice …
+ *     runner.dispose();
+ *
+ * Programs are cached per-`Transition` reference (WeakMap), so passing
+ * the same transition repeatedly compiles once and reuses thereafter.
+ * Source textures are likewise cached by identity via `@vysmo/gl-core`'s
+ * `TextureCache` — static images upload once.
+ *
+ * @throws Error if WebGL2 is unavailable in the host environment.
+ */
+export declare class Runner {
+    readonly gl: WebGL2RenderingContext;
+    private canvas;
+    private textures;
+    private programs;
+    private vao;
+    private defaultDisplacement;
+    private defaultEnvironment;
+    private defaultPrevious;
+    private fbPool;
+    private disposed;
+    private contextLost;
+    private readonly onContextLost;
+    private readonly onContextRestored;
+    private readonly handleContextLost;
+    private readonly handleContextRestored;
+    constructor(options: RunnerOptions);
+    private createDefaultDisplacement;
+    private createDefaultEnvironment;
+    private createDefaultPrevious;
+    private createSolidTexture;
+    /**
+     * Render one frame of `transition` at the given `progress` (0..1).
+     * `from` and `to` are the source and target images; the runner samples
+     * both via the same shader and crossfades / displaces / warps according
+     * to whatever GLSL the transition declares.
+     *
+     * Endpoint correctness is enforced by tests: at `progress === 0` the
+     * output is pixel-identical to `from`; at `progress === 1` it's
+     * pixel-identical to `to`.
+     *
+     * @param transition  Any `Transition` — built-in (`crossZoom`, `pageCurl`, …)
+     *                    or one returned from `defineTransition()`.
+     * @param args        `from`, `to`, `progress`, optional `params`
+     *                    overrides, optional `displacement` / `environment`
+     *                    aux textures (see `RenderArgs`).
+     *
+     * @throws Error if the runner is disposed or the WebGL context is lost.
+     * @throws Error if shader compilation or program linking fails.
+     */
+    render<P extends UniformParams>(transition: Transition<P>, args: RenderArgs<P>): void;
+    private renderFullscreen;
+    private renderMesh;
+    /**
+     * Whether the underlying WebGL context is currently lost. While lost,
+     * `render()` throws; wait for the `onContextRestored` callback.
+     */
+    get isContextLost(): boolean;
+    /**
+     * Free every GPU resource the runner owns (default textures, VAO,
+     * compiled programs, framebuffers, texture cache) and detach the
+     * context-loss listeners. Idempotent; further `render()` calls throw.
+     *
+     * Call when the canvas is going away (component unmount, route change,
+     * etc.) — the WebGL context itself is freed by the canvas, but
+     * disposing here releases the in-process bookkeeping early and removes
+     * the canvas listeners so the runner can be GC'd.
+     */
+    dispose(): void;
+    private getOrCompile;
+    private createMeshResources;
+    private uniformLoc;
+    private setUniform;
+}
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +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"}