@dopaminefx/core 0.1.0

package/dist/engine/look/particles.glsl.js

@@ -0,0 +1,44 @@
+/**
+ * Shared GPU-particle GLSL chunk.
+ *
+ * Solarbloom's drifting "motes" and Verdict's flung "droplets" are both
+ * point-sprite particle fields that differ only in their MOTION model (motes:
+ * outward drift + buoyancy + curl, with motion-blur streaks; droplets: a
+ * ballistic arc under gravity) and their styling. The cross-pollination plan
+ * asks for one parametric particle module behind a shared include + params.
+ *
+ * Here we extract the parts that were duplicated verbatim between the two: the
+ * per-particle soft round sprite (`particleSprite`), the ballistic position
+ * (`ballisticPos`), and the standard fade-in/out over a particle's life
+ * (`particleFade`). Each effect keeps its own emit shape + motion (the part that
+ * is its identity) and composes these shared primitives, so the dot falloff,
+ * the gravity arc and the lifetime curve no longer drift between effects.
+ *
+ * Comic debris can adopt the same primitives later (deferred — noted in the
+ * plan as P2). Requires no other chunk.
+ */
+export const GLSL_PARTICLES = /* glsl */ `
+// Soft round particle sprite: an inverse-distance dot that, squared, gives the
+// glowing-photon falloff both motes and droplets use. \`d\` is distance to the
+// particle centre, \`size\` its radius in device px.
+float particleSprite(float d, float size){
+  float s = size / (d + size * 0.5);
+  return s * s;
+}
+
+// Ballistic arc: launch from \`origin\` along \`dir\` at \`speed\`, pulled down by
+// \`gravity\` (device px) over normalized particle life \`t\` (0..1). Screen y is
+// up, so gravity subtracts on y. Used by Verdict's flung ink droplets and any
+// effect that wants sparks thrown off an impact.
+vec2 ballisticPos(vec2 origin, vec2 dir, float speed, float gravity, float t){
+  return origin + dir * speed * t - vec2(0.0, 1.0) * gravity * t * t;
+}
+
+// Standard particle fade: ramps in fast then fades out across its life. \`t\` is
+// normalized particle life (0..1); \`tailPow\` shapes the decay (higher = longer
+// luminous body before it dims).
+float particleFade(float t, float tailPow){
+  return (1.0 - pow(t, tailPow)) * smoothstep(0.0, 0.08, t);
+}
+`;
+//# sourceMappingURL=particles.glsl.js.map

package/dist/engine/look/particles.glsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"particles.glsl.js","sourceRoot":"","sources":["../../../src/engine/look/particles.glsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;CAuBxC,CAAC"}

package/dist/engine/sdf.d.ts

@@ -0,0 +1,77 @@
+/**
+ * SVG path → signed-distance-field (SDF) baker + runtime decoder.
+ *
+ * This is the "geometry seam": an effect's icon outline lives in its `.dope` as
+ * an `svgPath` string (authored, host-swappable). A BUILD step (scripts/bake-sdf
+ * or scripts/pack-dope) rasterizes that path into a small, self-contained SDF and
+ * inlines it into the distributed `.dope` (a `data:`-style base64 blob, no remote
+ * fetch). At RUNTIME the effect only DECODES + SAMPLES the SDF — it never does a
+ * live path→SDF conversion — so swapping the path in the `.dope` changes the
+ * rendered icon with no shader edit.
+ *
+ * The SDF here is a stroked-outline distance field: distance to the path's
+ * centerline (a polyline flattened from the bezier/line segments), so the icon
+ * reads as a *drawn stroke in light* (a tick, a cross, a custom mark), matching
+ * the "drawn-in-light" language of the built-ins. The field is signed only in the
+ * stroke sense (we store distance-to-stroke, with a coverage falloff applied at
+ * sample time by the shader against the declared stroke width), which is all the
+ * "drawn in light" look needs and keeps the bake free of robust point-in-polygon
+ * winding for arbitrary self-intersecting glyphs.
+ *
+ * Encoding (intentionally tiny, dependency-free, portable to Swift):
+ *   - a fixed-size square grid of `size`×`size` 8-bit samples,
+ *   - each sample = clamp(distance / range, 0..1) * 255 (0 = on the stroke,
+ *     255 = `range` author-units or more away),
+ *   - serialized as a 4-byte header (magic 'D','S', size hi/lo) + the bytes,
+ *     base64-encoded. `range` + `viewBox` travel as JSON next to the blob.
+ */
+/** A flattened 2D point in author/viewBox units. */
+export interface Pt {
+    x: number;
+    y: number;
+}
+/**
+ * Parse a (subset of) SVG path data into a list of polylines (each a list of
+ * points in author units). Supports absolute + relative M/L/H/V/C/Q/Z (the
+ * commands a designer's checkmark / cross / icon outline actually use). Curves
+ * are flattened to line segments at `steps` subdivisions — plenty for an SDF.
+ */
+export declare function parseSvgPath(d: string, steps?: number): Pt[][];
+/** A baked SDF: a square grid + the metadata a sampler needs. */
+export interface BakedSdf {
+    /** Grid resolution (square). */
+    size: number;
+    /** Author-units of distance that map to the full 0..255 byte range. */
+    range: number;
+    /** The viewBox the path was authored in: [minX, minY, w, h]. */
+    viewBox: [number, number, number, number];
+    /**
+     * A `data:` URI carrying the header + size×size 8-bit distance bytes (base64).
+     * A `data:` URI (not a remote/absolute ref) keeps the `.dope` self-contained
+     * and passes the loader's standalone guard. The runtime decodes + samples it.
+     */
+    data: string;
+}
+/**
+ * BAKE: rasterize an SVG path into a stroked-distance SDF. Pure + deterministic.
+ * `size` is the grid resolution; `range` is how many author-units of distance map
+ * to the full byte range (a larger range = a softer, wider usable falloff). The
+ * path is normalized into a centered square that preserves its aspect inside the
+ * grid, leaving a small margin so the stroke + its glow never clip the edge.
+ */
+export declare function bakeSdf(svgPath: string, viewBox: [number, number, number, number], size?: number, range?: number): BakedSdf;
+/** A decoded SDF ready to upload: the raw single-channel bytes + its size. */
+export interface DecodedSdf {
+    size: number;
+    range: number;
+    viewBox: [number, number, number, number];
+    /** size×size single-channel (0..255) distance bytes. */
+    bytes: Uint8Array;
+}
+/**
+ * DECODE a baked SDF blob back to its raw distance bytes. Validates the magic +
+ * the declared size against the byte count. Used by the runtime to upload an
+ * `R8`/alpha texture — the runtime SAMPLES this; it never re-bakes.
+ */
+export declare function decodeSdf(baked: BakedSdf): DecodedSdf;
+//# sourceMappingURL=sdf.d.ts.map

package/dist/engine/sdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdf.d.ts","sourceRoot":"","sources":["../../src/engine/sdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,oDAAoD;AACpD,MAAM,WAAW,EAAE;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,EAAE,EAAE,EAAE,CA8H1D;AAcD,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AA4BD;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACzC,IAAI,SAAK,EACT,KAAK,SAAK,GACT,QAAQ,CAiCV;AAED,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,wDAAwD;IACxD,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,CAcrD"}

package/dist/engine/sdf.js

@@ -0,0 +1,255 @@
+/**
+ * SVG path → signed-distance-field (SDF) baker + runtime decoder.
+ *
+ * This is the "geometry seam": an effect's icon outline lives in its `.dope` as
+ * an `svgPath` string (authored, host-swappable). A BUILD step (scripts/bake-sdf
+ * or scripts/pack-dope) rasterizes that path into a small, self-contained SDF and
+ * inlines it into the distributed `.dope` (a `data:`-style base64 blob, no remote
+ * fetch). At RUNTIME the effect only DECODES + SAMPLES the SDF — it never does a
+ * live path→SDF conversion — so swapping the path in the `.dope` changes the
+ * rendered icon with no shader edit.
+ *
+ * The SDF here is a stroked-outline distance field: distance to the path's
+ * centerline (a polyline flattened from the bezier/line segments), so the icon
+ * reads as a *drawn stroke in light* (a tick, a cross, a custom mark), matching
+ * the "drawn-in-light" language of the built-ins. The field is signed only in the
+ * stroke sense (we store distance-to-stroke, with a coverage falloff applied at
+ * sample time by the shader against the declared stroke width), which is all the
+ * "drawn in light" look needs and keeps the bake free of robust point-in-polygon
+ * winding for arbitrary self-intersecting glyphs.
+ *
+ * Encoding (intentionally tiny, dependency-free, portable to Swift):
+ *   - a fixed-size square grid of `size`×`size` 8-bit samples,
+ *   - each sample = clamp(distance / range, 0..1) * 255 (0 = on the stroke,
+ *     255 = `range` author-units or more away),
+ *   - serialized as a 4-byte header (magic 'D','S', size hi/lo) + the bytes,
+ *     base64-encoded. `range` + `viewBox` travel as JSON next to the blob.
+ */
+/**
+ * Parse a (subset of) SVG path data into a list of polylines (each a list of
+ * points in author units). Supports absolute + relative M/L/H/V/C/Q/Z (the
+ * commands a designer's checkmark / cross / icon outline actually use). Curves
+ * are flattened to line segments at `steps` subdivisions — plenty for an SDF.
+ */
+export function parseSvgPath(d, steps = 24) {
+    const polylines = [];
+    let cur = [];
+    let cx = 0;
+    let cy = 0;
+    let startX = 0;
+    let startY = 0;
+    // Tokenize into command letters + numeric runs.
+    const tokens = d.match(/[a-zA-Z]|-?\d*\.?\d+(?:e[-+]?\d+)?/gi) ?? [];
+    let i = 0;
+    const num = () => Number(tokens[i++]);
+    const has = () => i < tokens.length && /^-?\.?\d/.test(tokens[i]);
+    const push = (x, y) => {
+        cur.push({ x, y });
+        cx = x;
+        cy = y;
+    };
+    const flushCur = () => {
+        if (cur.length > 1)
+            polylines.push(cur);
+        cur = [];
+    };
+    let cmd = "";
+    while (i < tokens.length) {
+        const t = tokens[i];
+        if (/[a-zA-Z]/.test(t)) {
+            cmd = t;
+            i++;
+        }
+        else if (!cmd) {
+            i++;
+            continue;
+        }
+        const rel = cmd === cmd.toLowerCase();
+        switch (cmd.toUpperCase()) {
+            case "M": {
+                flushCur();
+                const x = num() + (rel ? cx : 0);
+                const y = num() + (rel ? cy : 0);
+                startX = x;
+                startY = y;
+                push(x, y);
+                cmd = rel ? "l" : "L"; // subsequent pairs are implicit lineto
+                while (has()) {
+                    const lx = num() + (rel ? cx : 0);
+                    const ly = num() + (rel ? cy : 0);
+                    push(lx, ly);
+                }
+                break;
+            }
+            case "L": {
+                do {
+                    const x = num() + (rel ? cx : 0);
+                    const y = num() + (rel ? cy : 0);
+                    push(x, y);
+                } while (has());
+                break;
+            }
+            case "H": {
+                do {
+                    const x = num() + (rel ? cx : 0);
+                    push(x, cy);
+                } while (has());
+                break;
+            }
+            case "V": {
+                do {
+                    const y = num() + (rel ? cy : 0);
+                    push(cx, y);
+                } while (has());
+                break;
+            }
+            case "C": {
+                do {
+                    const x1 = num() + (rel ? cx : 0);
+                    const y1 = num() + (rel ? cy : 0);
+                    const x2 = num() + (rel ? cx : 0);
+                    const y2 = num() + (rel ? cy : 0);
+                    const x = num() + (rel ? cx : 0);
+                    const y = num() + (rel ? cy : 0);
+                    const p0 = { x: cx, y: cy };
+                    for (let s = 1; s <= steps; s++) {
+                        const u = s / steps;
+                        const mt = 1 - u;
+                        const bx = mt * mt * mt * p0.x + 3 * mt * mt * u * x1 + 3 * mt * u * u * x2 + u * u * u * x;
+                        const by = mt * mt * mt * p0.y + 3 * mt * mt * u * y1 + 3 * mt * u * u * y2 + u * u * u * y;
+                        push(bx, by);
+                    }
+                } while (has());
+                break;
+            }
+            case "Q": {
+                do {
+                    const x1 = num() + (rel ? cx : 0);
+                    const y1 = num() + (rel ? cy : 0);
+                    const x = num() + (rel ? cx : 0);
+                    const y = num() + (rel ? cy : 0);
+                    const p0 = { x: cx, y: cy };
+                    for (let s = 1; s <= steps; s++) {
+                        const u = s / steps;
+                        const mt = 1 - u;
+                        const bx = mt * mt * p0.x + 2 * mt * u * x1 + u * u * x;
+                        const by = mt * mt * p0.y + 2 * mt * u * y1 + u * u * y;
+                        push(bx, by);
+                    }
+                } while (has());
+                break;
+            }
+            case "Z": {
+                if (cur.length) {
+                    push(startX, startY);
+                    flushCur();
+                }
+                break;
+            }
+            default:
+                // Unknown command — skip its number to avoid an infinite loop.
+                if (has())
+                    num();
+                break;
+        }
+    }
+    flushCur();
+    return polylines;
+}
+/** Distance from point p to segment a→b, in author units. */
+function distToSeg(px, py, ax, ay, bx, by) {
+    const dx = bx - ax;
+    const dy = by - ay;
+    const len2 = dx * dx + dy * dy;
+    let t = len2 > 1e-9 ? ((px - ax) * dx + (py - ay) * dy) / len2 : 0;
+    t = t < 0 ? 0 : t > 1 ? 1 : t;
+    const qx = ax + dx * t;
+    const qy = ay + dy * t;
+    return Math.hypot(px - qx, py - qy);
+}
+/** The MIME used for the inline SDF `data:` URI. */
+const SDF_MIME = "application/octet-stream";
+const SDF_DATA_PREFIX = `data:${SDF_MIME};base64,`;
+const MAGIC0 = 0x44; // 'D'
+const MAGIC1 = 0x53; // 'S'
+/** Encode raw bytes to base64 in both Node and the browser. */
+function bytesToBase64(bytes) {
+    if (typeof Buffer !== "undefined")
+        return Buffer.from(bytes).toString("base64");
+    let bin = "";
+    for (let i = 0; i < bytes.length; i++)
+        bin += String.fromCharCode(bytes[i]);
+    // eslint-disable-next-line no-undef
+    return btoa(bin);
+}
+/** Decode base64 to raw bytes in both Node and the browser. */
+function base64ToBytes(b64) {
+    if (typeof Buffer !== "undefined")
+        return new Uint8Array(Buffer.from(b64, "base64"));
+    // eslint-disable-next-line no-undef
+    const bin = atob(b64);
+    const out = new Uint8Array(bin.length);
+    for (let i = 0; i < bin.length; i++)
+        out[i] = bin.charCodeAt(i);
+    return out;
+}
+/**
+ * BAKE: rasterize an SVG path into a stroked-distance SDF. Pure + deterministic.
+ * `size` is the grid resolution; `range` is how many author-units of distance map
+ * to the full byte range (a larger range = a softer, wider usable falloff). The
+ * path is normalized into a centered square that preserves its aspect inside the
+ * grid, leaving a small margin so the stroke + its glow never clip the edge.
+ */
+export function bakeSdf(svgPath, viewBox, size = 64, range = 18) {
+    const polylines = parseSvgPath(svgPath);
+    const [vx, vy, vw, vh] = viewBox;
+    const bytes = new Uint8Array(size * size);
+    // Map a grid cell center to author/viewBox coordinates (y stays top-down, the
+    // shader flips as needed). The whole viewBox maps to the grid 0..size.
+    for (let gy = 0; gy < size; gy++) {
+        for (let gx = 0; gx < size; gx++) {
+            const ax = vx + ((gx + 0.5) / size) * vw;
+            const ay = vy + ((gy + 0.5) / size) * vh;
+            let best = Infinity;
+            for (const poly of polylines) {
+                for (let k = 0; k + 1 < poly.length; k++) {
+                    const d = distToSeg(ax, ay, poly[k].x, poly[k].y, poly[k + 1].x, poly[k + 1].y);
+                    if (d < best)
+                        best = d;
+                }
+            }
+            const norm = best === Infinity ? 1 : Math.min(1, best / range);
+            bytes[gy * size + gx] = Math.round(norm * 255);
+        }
+    }
+    const header = new Uint8Array(4);
+    header[0] = MAGIC0;
+    header[1] = MAGIC1;
+    header[2] = (size >> 8) & 0xff;
+    header[3] = size & 0xff;
+    const blob = new Uint8Array(header.length + bytes.length);
+    blob.set(header, 0);
+    blob.set(bytes, header.length);
+    return { size, range, viewBox, data: SDF_DATA_PREFIX + bytesToBase64(blob) };
+}
+/**
+ * DECODE a baked SDF blob back to its raw distance bytes. Validates the magic +
+ * the declared size against the byte count. Used by the runtime to upload an
+ * `R8`/alpha texture — the runtime SAMPLES this; it never re-bakes.
+ */
+export function decodeSdf(baked) {
+    const b64 = baked.data.startsWith(SDF_DATA_PREFIX)
+        ? baked.data.slice(SDF_DATA_PREFIX.length)
+        : baked.data; // tolerate a bare base64 blob too
+    const blob = base64ToBytes(b64);
+    if (blob.length < 4 || blob[0] !== MAGIC0 || blob[1] !== MAGIC1) {
+        throw new Error("dope: not a baked SDF blob (bad magic)");
+    }
+    const size = (blob[2] << 8) | blob[3];
+    const bytes = blob.subarray(4);
+    if (bytes.length !== size * size) {
+        throw new Error(`dope: SDF size mismatch (header ${size}^2 != ${bytes.length} bytes)`);
+    }
+    return { size, range: baked.range, viewBox: baked.viewBox, bytes: bytes.slice() };
+}
+//# sourceMappingURL=sdf.js.map

package/dist/engine/sdf.js.map

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

package/dist/engine/seed.d.ts

@@ -0,0 +1,10 @@
+/** Deterministic, seedable PRNG so a given `seed` always yields the same look. */
+export type Rng = () => number;
+/**
+ * mulberry32 — tiny, fast, good-enough-for-visuals PRNG. Returns values in
+ * [0, 1). Deterministic for a given 32-bit seed.
+ */
+export declare function mulberry32(seed: number): Rng;
+/** A fresh 32-bit seed — used when the caller doesn't pin one. */
+export declare function randomSeed(): number;
+//# sourceMappingURL=seed.d.ts.map

package/dist/engine/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/engine/seed.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,MAAM,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAS5C;AAED,kEAAkE;AAClE,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/engine/seed.js

@@ -0,0 +1,20 @@
+/** Deterministic, seedable PRNG so a given `seed` always yields the same look. */
+/**
+ * mulberry32 — tiny, fast, good-enough-for-visuals PRNG. Returns values in
+ * [0, 1). Deterministic for a given 32-bit seed.
+ */
+export function mulberry32(seed) {
+    let a = seed >>> 0;
+    return function next() {
+        a |= 0;
+        a = (a + 0x6d2b79f5) | 0;
+        let t = Math.imul(a ^ (a >>> 15), 1 | a);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/** A fresh 32-bit seed — used when the caller doesn't pin one. */
+export function randomSeed() {
+    return (Math.random() * 0xffffffff) >>> 0;
+}
+//# sourceMappingURL=seed.js.map

package/dist/engine/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/engine/seed.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAIlF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACnB,OAAO,SAAS,IAAI;QAClB,CAAC,IAAI,CAAC,CAAC;QACP,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IAC/C,CAAC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,UAAU;IACxB,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC"}

package/dist/engine/shadow.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shadow-pass geometry — the pure math that turns an effect's amplitude,
+ * "height" above the page, and stylization into the offset / softness /
+ * strength of the cast soft shadow. Kept framework- and GL-free so it can be
+ * unit-tested and reused by any effect that adopts the multiply shadow layer.
+ *
+ * Conventions (device pixels, gl coords where Y is UP):
+ *   - The implied key light sits up-and-left of the floating effect, so the
+ *     shadow falls DOWN-and-right: offset = (+x, -y).
+ *   - `offset` grows with the occluder's height and with amplitude (a brighter,
+ *     higher source throws a longer shadow).
+ *   - `soft` (penumbra blur radius) is larger for a soft photoreal source and
+ *     tightens toward the hard graphic drop-shadow of the cel end.
+ *   - `strength` is the max darkening of the multiply layer (0 = none); kept
+ *     ambient-occlusion subtle, a touch firmer toward cel.
+ */
+export interface ShadowGeometry {
+    /** Silhouette offset in device px, gl coords (x right, y up). */
+    offsetX: number;
+    offsetY: number;
+    /** Penumbra blur tap radius in device px. */
+    soft: number;
+    /** Max multiply darkening, 0..1. */
+    strength: number;
+}
+export interface ShadowInput {
+    /** Smaller canvas dimension in device px. */
+    minDim: number;
+    /**
+     * The occluder's "height" above the page as a fraction of `minDim` — bigger
+     * forms read as floating higher and cast longer, softer shadows. For
+     * Solarbloom this is the bloom radius fraction; for Verdict, the stroke scale.
+     */
+    heightFrac: number;
+    /** Envelope amplitude (peaks > 1). */
+    amp: number;
+    /** Stylization 0..1 (photoreal → cel). */
+    style: number;
+}
+export declare function shadowGeometry({ minDim, heightFrac, amp, style }: ShadowInput): ShadowGeometry;
+//# sourceMappingURL=shadow.d.ts.map

package/dist/engine/shadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow.d.ts","sourceRoot":"","sources":["../../src/engine/shadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;CACf;AAKD,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,WAAW,GAAG,cAAc,CAoB9F"}

package/dist/engine/shadow.js

@@ -0,0 +1,39 @@
+/**
+ * Shadow-pass geometry — the pure math that turns an effect's amplitude,
+ * "height" above the page, and stylization into the offset / softness /
+ * strength of the cast soft shadow. Kept framework- and GL-free so it can be
+ * unit-tested and reused by any effect that adopts the multiply shadow layer.
+ *
+ * Conventions (device pixels, gl coords where Y is UP):
+ *   - The implied key light sits up-and-left of the floating effect, so the
+ *     shadow falls DOWN-and-right: offset = (+x, -y).
+ *   - `offset` grows with the occluder's height and with amplitude (a brighter,
+ *     higher source throws a longer shadow).
+ *   - `soft` (penumbra blur radius) is larger for a soft photoreal source and
+ *     tightens toward the hard graphic drop-shadow of the cel end.
+ *   - `strength` is the max darkening of the multiply layer (0 = none); kept
+ *     ambient-occlusion subtle, a touch firmer toward cel.
+ */
+const clamp = (x, lo, hi) => x < lo ? lo : x > hi ? hi : x;
+export function shadowGeometry({ minDim, heightFrac, amp, style }) {
+    const height = heightFrac * minDim;
+    // Offset length: scales with height and (clamped) amplitude. A meaningful
+    // drop so the silhouette clears the bright core (which the screen light owns)
+    // and lands as a distinct shadow on the UI beside/below it.
+    const off = height * 0.16 * (0.6 + 0.5 * Math.min(amp, 1.5));
+    // Penumbra: wide & soft when photoreal, tight when cel; always a small floor.
+    const soft = minDim * 0.014 * (1 - 0.6 * style) + minDim * 0.005;
+    // Darkening of the multiply layer. Kept ambient at the soft end, firmer (a
+    // graphic drop-shadow) toward cel. Reads clearly where it falls on the
+    // lighter raised faces / the white primary button.
+    const strength = clamp(0.6 * (0.8 + 0.45 * style), 0, 1);
+    return {
+        // Down-and-right: x positive, y negative (gl Y up). x is a fraction of the
+        // drop so the shadow leans, not straight down.
+        offsetX: off * 0.55,
+        offsetY: -off,
+        soft,
+        strength,
+    };
+}
+//# sourceMappingURL=shadow.js.map

package/dist/engine/shadow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow.js","sourceRoot":"","sources":["../../src/engine/shadow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA2BH,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU,EAAU,EAAE,CAC1D,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhC,MAAM,UAAU,cAAc,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAe;IAC5E,MAAM,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;IACnC,0EAA0E;IAC1E,8EAA8E;IAC9E,4DAA4D;IAC5D,MAAM,GAAG,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7D,8EAA8E;IAC9E,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC;IACjE,2EAA2E;IAC3E,uEAAuE;IACvE,mDAAmD;IACnD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO;QACL,2EAA2E;QAC3E,+CAA+C;QAC/C,OAAO,EAAE,GAAG,GAAG,IAAI;QACnB,OAAO,EAAE,CAAC,GAAG;QACb,IAAI;QACJ,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/engine/tempo.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Animation tempo PRIMITIVES — the generic easing + envelope building blocks
+ * shared across effects.
+ *
+ * Linear motion reads as unnatural, so everything here is eased. These are the
+ * GENERIC primitives only: each effect's BESPOKE envelope (the comic slam, the
+ * fail stamp/shake, the heartburst lub-dub, the lightning strike/strobe, the
+ * solarbloom check draw, the inkstroke stroke draw, …) lives in that effect's
+ * own `<name>-tempo.ts` inside `@dopaminefx/effect-<name>`, built on top of these.
+ */
+/**
+ * Coarse animation step (ms) for the hand-drawn "animate on twos" look at full
+ * whimsy — ~12 updates/sec, i.e. 24fps on twos. Motion is snapped toward this
+ * grid as style rises (see the pass-runner), giving discrete, posed beats
+ * instead of smooth interpolation.
+ */
+export declare const NPR_TIME_STEP_MS: number;
+/** Clamp a value into [0, 1]. */
+export declare const clamp01: (x: number) => number;
+/** Classic ease-out cubic — quick start, gentle settle. */
+export declare function easeOutCubic(x: number): number;
+/**
+ * Ease-out "back" — overshoots past 1 then settles exactly to 1 at x=1. This is
+ * the held-breath release. `overshoot` scales how far past 1 it swells.
+ */
+export declare function easeOutBack(x: number, overshoot?: number): number;
+/**
+ * Bloom amplitude over normalized life `t` ∈ [0, 1].
+ * Fast attack with overshoot in the first ~18%, then a long decay to zero.
+ * `envelope(0) === 0`, `envelope(1) === 0`, peak > 1 during the attack.
+ */
+export declare function envelope(t: number, overshoot?: number): number;
+//# sourceMappingURL=tempo.d.ts.map

package/dist/engine/tempo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempo.d.ts","sourceRoot":"","sources":["../../src/engine/tempo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAY,CAAC;AAE1C,iCAAiC;AACjC,eAAO,MAAM,OAAO,GAAI,GAAG,MAAM,KAAG,MAAqC,CAAC;AAE1E,2DAA2D;AAC3D,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM,CAK5D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,MAAM,CASzD"}

package/dist/engine/tempo.js

@@ -0,0 +1,51 @@
+/**
+ * Animation tempo PRIMITIVES — the generic easing + envelope building blocks
+ * shared across effects.
+ *
+ * Linear motion reads as unnatural, so everything here is eased. These are the
+ * GENERIC primitives only: each effect's BESPOKE envelope (the comic slam, the
+ * fail stamp/shake, the heartburst lub-dub, the lightning strike/strobe, the
+ * solarbloom check draw, the inkstroke stroke draw, …) lives in that effect's
+ * own `<name>-tempo.ts` inside `@dopaminefx/effect-<name>`, built on top of these.
+ */
+/**
+ * Coarse animation step (ms) for the hand-drawn "animate on twos" look at full
+ * whimsy — ~12 updates/sec, i.e. 24fps on twos. Motion is snapped toward this
+ * grid as style rises (see the pass-runner), giving discrete, posed beats
+ * instead of smooth interpolation.
+ */
+export const NPR_TIME_STEP_MS = 1000 / 12;
+/** Clamp a value into [0, 1]. */
+export const clamp01 = (x) => (x < 0 ? 0 : x > 1 ? 1 : x);
+/** Classic ease-out cubic — quick start, gentle settle. */
+export function easeOutCubic(x) {
+    const t = clamp01(x);
+    return 1 - Math.pow(1 - t, 3);
+}
+/**
+ * Ease-out "back" — overshoots past 1 then settles exactly to 1 at x=1. This is
+ * the held-breath release. `overshoot` scales how far past 1 it swells.
+ */
+export function easeOutBack(x, overshoot = 1) {
+    const t = clamp01(x);
+    const c1 = 1.70158 * overshoot;
+    const c3 = c1 + 1;
+    return 1 + c3 * Math.pow(t - 1, 3) + c1 * Math.pow(t - 1, 2);
+}
+/**
+ * Bloom amplitude over normalized life `t` ∈ [0, 1].
+ * Fast attack with overshoot in the first ~18%, then a long decay to zero.
+ * `envelope(0) === 0`, `envelope(1) === 0`, peak > 1 during the attack.
+ */
+export function envelope(t, overshoot = 1) {
+    if (t <= 0 || t >= 1)
+        return 0;
+    const attack = 0.18;
+    if (t < attack) {
+        return easeOutBack(t / attack, overshoot);
+    }
+    const x = (t - attack) / (1 - attack);
+    // Decays from 1 → 0; exponent > 1 keeps a slow, luxurious tail.
+    return Math.pow(1 - x, 1.6);
+}
+//# sourceMappingURL=tempo.js.map

package/dist/engine/tempo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempo.js","sourceRoot":"","sources":["../../src/engine/tempo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAE,CAAC;AAE1C,iCAAiC;AACjC,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE1E,2DAA2D;AAC3D,MAAM,UAAU,YAAY,CAAC,CAAS;IACpC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,SAAS,GAAG,CAAC;IAClD,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClB,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,CAAS,EAAE,SAAS,GAAG,CAAC;IAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;QACf,OAAO,WAAW,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC;IACtC,gEAAgE;IAChE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC"}