@dopaminefx/effect-heartburst 0.1.0

package/dist/heartburst-renderer.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Heartburst Canvas2D PANEL drawing.
+ *
+ * The crisp, vector-y parts of Heartburst — the big swelling hero heart and the
+ * flurry of little hearts that fly out on the burst — are drawn into an OFFSCREEN
+ * Canvas2D each frame (cheap: a couple dozen filled paths) and uploaded as the
+ * "panel" texture; the fragment shader (heartburst-shader.ts) adds the soft warm
+ * bloom, the gloss highlight, the halftone blush, the noir↔pop styling, the beat
+ * flash and casts the warm light + soft shadow.
+ *
+ * Both the hero and the little hearts are a single parametric HEART CURVE (the
+ * classic `16sin³t` cardioid-ish heart) traced as a Canvas2D path, so the form
+ * is true vector geometry the GPU can't easily do.
+ *
+ * Panel channel encoding consumed by the shader:
+ *   R = hero heart FILL   ·  G = INK (outline) + gloss seed  ·  B = burst hearts FILL
+ */
+import { type PanelDraw } from "@dopaminefx/core";
+/** Fraction of life occupied by the lub-dub beat phase before the burst. */
+export declare const HEARTBEAT_PHASE = 0.3;
+/**
+ * Heart SCALE multiplier over normalized life. A resting 1.0 with two beats
+ * superimposed, then it settles to rest through the burst and gently shrinks as
+ * it fades. `strength` scales beat swell; `doubleBeat` blends single → lub-dub.
+ */
+export declare function heartbeatScale(life: number, strength?: number, doubleBeat?: number): number;
+/**
+ * The amplitude/energy envelope (→ uAmp + shadow strength). Tracks the beats
+ * during the lub-dub then a bright flare at the burst, decaying through the
+ * afterglow. NOTE: shipped as DATA (`tempo.frame.amp`); this copy exists only
+ * so the tests can pin the data delta-0 against the readable formula.
+ */
+export declare function heartburstEnvelope(life: number, strength?: number, doubleBeat?: number): number;
+/**
+ * Burst progress 0..1 over the post-beat phase: 0 until the dub finishes, then
+ * eases out to 1 as the little hearts fly out and fade.
+ */
+export declare function burstProgress(life: number): number;
+/**
+ * Overall panel presence over normalized life: a quick snap-in, a proud hold
+ * through the beats + burst, then a clean fade at the tail so the panel clears.
+ */
+export declare function heartPresence(life: number): number;
+/** Resolved render params Heartburst's panel + shader consume. */
+export interface HeartburstRenderParams {
+    durationMs: number;
+    palette: unknown;
+    style: number;
+    heartburstSeed: number;
+    heartScale: number;
+    burstCount: number;
+    burstSpread: number;
+    inkWeight: number;
+    beatStrength: number;
+    doubleBeat: number;
+    dotSize: number;
+    exposure: number;
+    glow: number;
+    gloss: number;
+    halftone: number;
+    saturation: number;
+}
+/**
+ * Draw the offscreen panel for this frame.
+ *  - the hero heart at the current beat scale, fill in RED, outline in GREEN,
+ *    plus a gloss-highlight blob painted into GREEN that sits ON the fill (the
+ *    shader reads ink∩fill as the specular seed),
+ *  - the little burst hearts flying outward along seeded arcs, fill in BLUE.
+ *
+ * `heartScaleMul` is the lub-dub beat multiplier on the hero (1 at rest).
+ * `presence` fades the whole panel in/out.
+ */
+/**
+ * The per-frame panel draw in the generic `PanelDraw` shape — the ONE
+ * code-shaped hook the data-driven factory wires (`registerDopePanelEffect`).
+ * Computes the draw-side tempo (beat scale, presence, target span) and hands
+ * off to {@link drawHeartburstPanel}.
+ */
+export declare const drawHeartburstFrame: PanelDraw;
+export declare function drawHeartburstPanel(ctx: CanvasRenderingContext2D, w: number, h: number, params: HeartburstRenderParams, heartScaleMul: number, life: number, presence: number, dpr: number, center: {
+    x: number;
+    y: number;
+}, span: number): void;
+//# sourceMappingURL=heartburst-renderer.d.ts.map

package/dist/heartburst-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartburst-renderer.d.ts","sourceRoot":"","sources":["../src/heartburst-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAcrF,4EAA4E;AAC5E,eAAO,MAAM,eAAe,MAAM,CAAC;AAanC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,SAAI,GAAG,MAAM,CAOjF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,SAAI,EAAE,UAAU,SAAI,GAAG,MAAM,CASrF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkCD;;;;;;;;;GASG;AACH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAMjC,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,wBAAwB,EAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,sBAAsB,EAC9B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,IAAI,EAAE,MAAM,GACX,IAAI,CAsGN"}

package/dist/heartburst-renderer.js

@@ -0,0 +1,247 @@
+/**
+ * Heartburst Canvas2D PANEL drawing.
+ *
+ * The crisp, vector-y parts of Heartburst — the big swelling hero heart and the
+ * flurry of little hearts that fly out on the burst — are drawn into an OFFSCREEN
+ * Canvas2D each frame (cheap: a couple dozen filled paths) and uploaded as the
+ * "panel" texture; the fragment shader (heartburst-shader.ts) adds the soft warm
+ * bloom, the gloss highlight, the halftone blush, the noir↔pop styling, the beat
+ * flash and casts the warm light + soft shadow.
+ *
+ * Both the hero and the little hearts are a single parametric HEART CURVE (the
+ * classic `16sin³t` cardioid-ish heart) traced as a Canvas2D path, so the form
+ * is true vector geometry the GPU can't easily do.
+ *
+ * Panel channel encoding consumed by the shader:
+ *   R = hero heart FILL   ·  G = INK (outline) + gloss seed  ·  B = burst hearts FILL
+ */
+import { easeOutCubic, clamp01, mulberry32 } from "@dopaminefx/core";
+// ---------------------------------------------------------------------------
+// DRAW-side tempo. The per-frame UNIFORM logic (amp/presence/beat/burst/flash)
+// is DATA — `tempo.frame` in heartburst.dope.json, evaluated by the core
+// frame-expr evaluator (pinned delta-0 against these functions by the tests).
+// The same curves are ALSO needed by the panel GEOMETRY (the hero swells with
+// the beat, the little hearts fly out with the burst), and panel geometry is
+// code by design — so the draw-side copies live here, next to the draw.
+//
+//   life 0.00 .. 0.30  : LUB-DUB — two beats; the second tucked behind the first
+//   life 0.30 .. 1.00  : BURST + AFTERGLOW — little hearts fly out, hero fades
+// ---------------------------------------------------------------------------
+/** Fraction of life occupied by the lub-dub beat phase before the burst. */
+export const HEARTBEAT_PHASE = 0.3;
+/**
+ * A single soft beat pulse centred at `center` (in life units) with half-width
+ * `width`: rises fast, eases back down. Returns 0..1 (peak 1 at `center`).
+ */
+function beatPulse(t, center, width) {
+    const x = (t - center) / width;
+    if (x <= -1 || x >= 1)
+        return 0;
+    const lobe = 0.5 + 0.5 * Math.cos(x * Math.PI);
+    return x < 0 ? Math.pow(lobe, 0.7) : Math.pow(lobe, 1.4);
+}
+/**
+ * Heart SCALE multiplier over normalized life. A resting 1.0 with two beats
+ * superimposed, then it settles to rest through the burst and gently shrinks as
+ * it fades. `strength` scales beat swell; `doubleBeat` blends single → lub-dub.
+ */
+export function heartbeatScale(life, strength = 1, doubleBeat = 1) {
+    const t = clamp01(life);
+    const lub = beatPulse(t, 0.1, 0.1);
+    const dub = beatPulse(t, 0.21, 0.075) * 0.62 * clamp01(doubleBeat);
+    const beat = Math.max(lub, dub);
+    const sag = t > HEARTBEAT_PHASE ? 0.06 * easeOutCubic((t - HEARTBEAT_PHASE) / (1 - HEARTBEAT_PHASE)) : 0;
+    return 1 + beat * 0.42 * strength - sag;
+}
+/**
+ * The amplitude/energy envelope (→ uAmp + shadow strength). Tracks the beats
+ * during the lub-dub then a bright flare at the burst, decaying through the
+ * afterglow. NOTE: shipped as DATA (`tempo.frame.amp`); this copy exists only
+ * so the tests can pin the data delta-0 against the readable formula.
+ */
+export function heartburstEnvelope(life, strength = 1, doubleBeat = 1) {
+    const t = clamp01(life);
+    if (t <= 0 || t >= 1)
+        return 0;
+    const lub = beatPulse(t, 0.1, 0.1);
+    const dub = beatPulse(t, 0.21, 0.075) * 0.62 * clamp01(doubleBeat);
+    const beats = Math.max(lub, dub) * 0.9 * strength;
+    const b = burstProgress(life);
+    const flare = b * Math.pow(1 - b, 1.1) * 2.4;
+    return clamp01(Math.max(beats, flare * (0.7 + 0.3 * strength)));
+}
+/**
+ * Burst progress 0..1 over the post-beat phase: 0 until the dub finishes, then
+ * eases out to 1 as the little hearts fly out and fade.
+ */
+export function burstProgress(life) {
+    const t = clamp01(life);
+    if (t <= HEARTBEAT_PHASE)
+        return 0;
+    return easeOutCubic((t - HEARTBEAT_PHASE) / (1 - HEARTBEAT_PHASE));
+}
+/**
+ * Overall panel presence over normalized life: a quick snap-in, a proud hold
+ * through the beats + burst, then a clean fade at the tail so the panel clears.
+ */
+export function heartPresence(life) {
+    const t = life < 0 ? 0 : life > 1 ? 1 : life;
+    if (t < 0.04)
+        return t / 0.04;
+    if (t < 0.8)
+        return 1;
+    const fade = 1 - (t - 0.8) / 0.2;
+    return Math.pow(Math.max(0, fade), 1.4);
+}
+/**
+ * Trace a parametric heart of half-size `s` centred at the current origin into
+ * the given context's current path. `rot` rotates it (radians). The classic
+ * heart curve, normalized so its bounding extent ≈ `s` and the cusp points UP.
+ */
+/** Hero-heart size relative to the targeted element box (≈1.5×). See the Swift
+ * `HEARTBURST_TARGET_FILL` — keep the two in sync. */
+const HEARTBURST_TARGET_FILL = 3.6;
+function traceHeart(ctx, s, rot) {
+    const steps = 48;
+    ctx.beginPath();
+    for (let i = 0; i <= steps; i++) {
+        const t = (i / steps) * Math.PI * 2;
+        // x in [-16,16], y in roughly [-17,12] for the standard curve.
+        const x = 16 * Math.pow(Math.sin(t), 3);
+        const y = 13 * Math.cos(t) -
+            5 * Math.cos(2 * t) -
+            2 * Math.cos(3 * t) -
+            Math.cos(4 * t);
+        // Normalize to ~[-1,1] and flip Y so the lobes are at the top (canvas y-down).
+        const nx = (x / 17) * s;
+        const ny = (-y / 17) * s;
+        const cx = nx * Math.cos(rot) - ny * Math.sin(rot);
+        const cy = nx * Math.sin(rot) + ny * Math.cos(rot);
+        if (i === 0)
+            ctx.moveTo(cx, cy);
+        else
+            ctx.lineTo(cx, cy);
+    }
+    ctx.closePath();
+}
+/**
+ * Draw the offscreen panel for this frame.
+ *  - the hero heart at the current beat scale, fill in RED, outline in GREEN,
+ *    plus a gloss-highlight blob painted into GREEN that sits ON the fill (the
+ *    shader reads ink∩fill as the specular seed),
+ *  - the little burst hearts flying outward along seeded arcs, fill in BLUE.
+ *
+ * `heartScaleMul` is the lub-dub beat multiplier on the hero (1 at rest).
+ * `presence` fades the whole panel in/out.
+ */
+/**
+ * The per-frame panel draw in the generic `PanelDraw` shape — the ONE
+ * code-shaped hook the data-driven factory wires (`registerDopePanelEffect`).
+ * Computes the draw-side tempo (beat scale, presence, target span) and hands
+ * off to {@link drawHeartburstPanel}.
+ */
+export const drawHeartburstFrame = (pctx, w, h, params, info) => {
+    const p = params;
+    const scale = heartbeatScale(info.life, p.beatStrength, p.doubleBeat);
+    const presence = heartPresence(info.life);
+    const span = Math.min(info.targetPx.width, info.targetPx.height);
+    drawHeartburstPanel(pctx, w, h, p, scale, info.life, presence, info.dpr, info.centerPx, span);
+};
+export function drawHeartburstPanel(ctx, w, h, params, heartScaleMul, life, presence, dpr, center, span) {
+    ctx.clearRect(0, 0, w, h);
+    if (presence <= 0.001)
+        return;
+    // Position the hearts on the targeted element (centre) and size them to its box
+    // (`span`), so the centrepiece matches the page element instead of the canvas.
+    const cx = center.x;
+    const cy = center.y;
+    // The hero heart reads at ~150% of the targeted element (heartScale ~0.22 ⇒
+    // heart extent ≈ 1.5× the box), clamped to the canvas so a full-page fire
+    // (target == canvas) keeps its original size. Sync w/ HeartburstPanel.swift.
+    const minDim = Math.min(span * HEARTBURST_TARGET_FILL, Math.min(w, h));
+    const seed = (params.heartburstSeed * 1000) >>> 0;
+    const rng = mulberry32(seed);
+    const ink = Math.max(1, params.inkWeight * dpr);
+    // ---------- HERO HEART (R fill, G outline + gloss seed) ------------------
+    const heroS = minDim * params.heartScale * heartScaleMul;
+    // a tiny per-fire tilt so it feels hand-placed.
+    const tilt = ((params.heartburstSeed % 1) - 0.5) * 0.12;
+    // As the burst takes over, the hero heart shrinks/cracks open a touch so the
+    // little hearts read as having spilled OUT of it.
+    const b = burstProgress(life);
+    const heroPresence = presence * (1 - 0.65 * b);
+    ctx.save();
+    ctx.translate(cx, cy);
+    ctx.globalCompositeOperation = "lighter"; // additive into channels
+    if (heroPresence > 0.002) {
+        const heroFillA = Math.round(255 * heroPresence);
+        // FILL -> RED.
+        traceHeart(ctx, heroS, tilt);
+        ctx.fillStyle = `rgba(${heroFillA},0,0,1)`;
+        ctx.fill();
+        // OUTLINE -> GREEN.
+        traceHeart(ctx, heroS, tilt);
+        ctx.lineJoin = "round";
+        ctx.lineWidth = ink * 1.6;
+        ctx.strokeStyle = `rgba(0,${heroFillA},0,1)`;
+        ctx.stroke();
+        // GLOSS SEED -> GREEN, painted ON the fill (upper-left lobe). The shader
+        // reads ink∩fill as the specular highlight, so a soft blob here becomes the
+        // gel-heart shine. Clip to the heart so it never bleeds past the silhouette.
+        ctx.save();
+        traceHeart(ctx, heroS, tilt);
+        ctx.clip();
+        const gx = -heroS * 0.34;
+        const gy = -heroS * 0.42;
+        const gr = heroS * 0.42;
+        const grad = ctx.createRadialGradient(gx, gy, 0, gx, gy, gr);
+        grad.addColorStop(0, `rgba(0,${heroFillA},0,1)`);
+        grad.addColorStop(1, "rgba(0,0,0,0)");
+        ctx.fillStyle = grad;
+        ctx.beginPath();
+        ctx.arc(gx, gy, gr, 0, Math.PI * 2);
+        ctx.fill();
+        ctx.restore();
+    }
+    ctx.restore();
+    // ---------- BURST HEARTS (B fill) ----------------------------------------
+    // A flurry of little hearts fly outward along seeded directions, arc under a
+    // little "gravity", spin, and shrink as they go. Fully crisp vector hearts.
+    if (b > 0.001) {
+        const count = Math.max(0, Math.round(params.burstCount));
+        const maxDist = minDim * params.burstSpread;
+        ctx.save();
+        ctx.globalCompositeOperation = "lighter";
+        for (let i = 0; i < count; i++) {
+            // deterministic per-heart launch params.
+            const ang = (i / count) * Math.PI * 2 + (rng() - 0.5) * 0.9;
+            const speed = 0.55 + rng() * 0.45; // some fly farther
+            const spin = (rng() - 0.5) * 2.0;
+            const littleS = minDim * (0.035 + rng() * 0.04) * params.heartScale * 1.6;
+            // staggered launch so they don't all leave at once.
+            const stagger = rng() * 0.25;
+            const lp = Math.max(0, Math.min(1, (b - stagger) / (1 - stagger)));
+            if (lp <= 0)
+                continue;
+            const dist = maxDist * speed * lp;
+            // arc: a parabola so they rise then fall slightly.
+            const arc = minDim * 0.10 * speed * (lp - lp * lp) * 4.0;
+            const px = cx + Math.cos(ang) * dist;
+            const py = cy + Math.sin(ang) * dist - arc;
+            // fade + shrink late in the flight.
+            const fade = 1 - Math.pow(lp, 2.2);
+            if (fade <= 0.01)
+                continue;
+            const a = Math.round(255 * presence * fade);
+            const s = littleS * (0.6 + 0.4 * (1 - lp));
+            ctx.save();
+            ctx.translate(px, py);
+            traceHeart(ctx, s, spin * lp * Math.PI);
+            ctx.fillStyle = `rgba(0,0,${a},1)`;
+            ctx.fill();
+            ctx.restore();
+        }
+        ctx.restore();
+    }
+}
+//# sourceMappingURL=heartburst-renderer.js.map

package/dist/heartburst-renderer.js.map

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

package/dist/heartburst-shader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * GLSL ES 3.00 source for **Heartburst** — Dopamine's love / like / favorite
+ * moment: a heart swells with a double-beat (lub-dub) then BURSTS into a flurry
+ * of small hearts that fly outward, arc, and fade.
+ *
+ * This is a HYBRID (Canvas2D-panel) effect. The crisp vector hearts — the big
+ * hero heart and the little burst hearts — are drawn with a parametric heart
+ * curve into an OFFSCREEN Canvas2D each frame (heartburst-renderer.ts) and
+ * handed to this shader as a single "panel" texture. The shader then does
+ * everything that wants to be procedural / screen-space:
+ *   - a soft warm BLOOM behind the heart (the love glow),
+ *   - a tight GLOSS / specular highlight on the hero heart at the photoreal end,
+ *   - the NOIR ↔ POP styling: a moody near-monochrome heart with one warm spot
+ *     color (noir) → a flat saturated cel "sticker" heart with a hard rim and
+ *     halftone blush (pop), keyed off uStyle/uSaturation,
+ *   - a hot beat FLASH that throws warm light onto the page (the cast).
+ *
+ * Everything is summed as light (canvas is black, composited via
+ * `mix-blend-mode: screen`, so black == no change, bright == cast light).
+ *
+ * Panel texture channel encoding (see heartburst-renderer.ts):
+ *   R = hero heart FILL mask  (the big swelling heart's interior)
+ *   G = INK / contour mask    (heart outline + the gloss seed highlight)
+ *   B = burst hearts FILL     (all the little flying hearts)
+ *   A = unused
+ *
+ * Pure function of uniforms → frame-perfect & cheap under SwiftShader.
+ */
+export declare const HEARTBURST_VERTEX_SRC = "#version 300 es\nout vec2 vUv;\nvoid main() {\n  vec2 pos = vec2(float((gl_VertexID << 1) & 2), float(gl_VertexID & 2));\n  vUv = pos;\n  gl_Position = vec4(pos * 2.0 - 1.0, 0.0, 1.0);\n}";
+export declare const HEARTBURST_FRAGMENT_SRC = "#version 300 es\nprecision highp float;\nin vec2 vUv;\nout vec4 fragColor;\n\nuniform sampler2D uPanel;     // R=heartFill G=ink B=burstFill\nuniform vec2  uResolution;    // device pixels\nuniform vec2  uOrigin;        // heart centre (the anchor), device px\nuniform float uLife;          // whole-effect progress 0..1\nuniform float uTimeS;         // elapsed seconds\nuniform float uPresence;      // panel opacity / presence 0..1\nuniform float uBeat;          // 0..1 current beat amplitude (lub-dub thump)\nuniform float uBurst;         // 0..1 burst progress (little hearts flying out)\nuniform float uFlash;         // 0..1 warm beat/burst flash amount\nuniform float uExposure;      // cast-light gain\nuniform float uGlow;          // 0..1 soft bloom radius/strength behind the heart\nuniform float uGloss;         // 0..1 specular gloss on the hero heart (photoreal)\nuniform float uHalftone;      // 0..1 Ben-Day blush dot strength (pop)\nuniform float uDotSize;       // halftone cell size in device px\nuniform float uSaturation;    // 0..1 panel color saturation (noir->pop)\nuniform float uSeed;          // per-fire hash\nuniform float uStyle;         // 0..1 photoreal/noir -> flat cel sticker (whimsy)\nuniform float uShadow;        // 0 = light pass (screen), 1 = shadow pass (multiply)\nuniform vec2  uShadowOffset;  // device-px offset of the cast silhouette\nuniform float uShadowSoft;    // penumbra softness in device px\nuniform float uShadowStrength;// 0..1 max darkening of the multiply layer\nuniform vec3  uC0;            // hero heart core color (warm red)\nuniform vec3  uC1;            // heart shade / burst color (pink/coral)\nuniform vec3  uC2;            // accent / glow / blush color\n\n\n#define TAU 6.28318530718\n\n\nfloat hash11(float p){ p = fract(p * 0.1031); p *= p + 33.33; p *= p + p; return fract(p); }\nvec2 hash21(float p){\n  vec3 p3 = fract(vec3(p) * vec3(0.1031, 0.1030, 0.0973));\n  p3 += dot(p3, p3.yzx + 33.33);\n  return fract((p3.xx + p3.yz) * p3.zy);\n}\n\n\nmat2 rot2(float a){ float s = sin(a), c = cos(a); return mat2(c, -s, s, c); }\n\n\nfloat benday(vec2 frag, float cell, float v, float ang){\n  vec2 p = rot2(ang) * frag / cell;\n  vec2 g = fract(p) - 0.5;\n  float d = length(g);\n  float r = 0.52 * sqrt(clamp(v, 0.0, 1.0));\n  float aa = 0.7 / cell + fwidth(d);\n  return 1.0 - smoothstep(r - aa, r + aa, d);\n}\n\n\nvec3 tonemapACES(vec3 x){\n  const float a = 2.51, b = 0.03, c = 2.43, d = 0.59, e = 0.14;\n  return clamp((x * (a * x + b)) / (x * (c * x + d) + e), 0.0, 1.0);\n}\n\n\nvec3 ditherAdd(vec3 col, vec2 frag, float t, float fade){\n  float dz = hash11(dot(frag, vec2(12.989, 78.233)) + t) - 0.5;\n  return col + (dz / 255.0) * fade;\n}\n\n\nvoid main(){\n  vec2 frag = vUv * uResolution;\n  vec2 res = uResolution;\n  float minDim = min(res.x, res.y);\n\n  // ---- SHADOW PASS (multiply layer) ---------------------------------------\n  // Cheap occlusion: the panel's solid forms (hero + burst fills) sampled at an\n  // offset toward the implied key light, with a small ring blur for a penumbra.\n  // White = no shadow (multiply identity); darker = cast shadow. Presence fades\n  // it with the effect.\n  if (uShadow > 0.5) {\n    vec2 px = 1.0 / res;\n    vec2 souv = vUv - uShadowOffset * px;\n    float occ = 0.0;\n    for (int i = 0; i < 8; i++) {\n      float a = float(i) / 8.0 * TAU;\n      vec2 o = vec2(cos(a), sin(a)) * uShadowSoft * px;\n      vec2 tuv = souv + o;\n      vec2 inb = step(vec2(0.0), tuv) * step(tuv, vec2(1.0));\n      float mask = inb.x * inb.y;\n      vec4 s = texture(uPanel, tuv);\n      occ += clamp(s.r + s.b, 0.0, 1.0) * mask;\n    }\n    occ /= 8.0;\n    float dark = clamp(occ * uShadowStrength, 0.0, 1.0);\n    fragColor = vec4(vec3(1.0 - dark), 1.0);\n    return;\n  }\n\n  vec2 fromC = frag - uOrigin;\n  float rad = length(fromC);\n\n  vec4 panel = texture(uPanel, vUv);\n  float heartFill = panel.r;\n  float ink = panel.g;\n  float burstFill = panel.b;\n\n  vec3 col = vec3(0.0);\n\n  // ---- SOFT BLOOM behind the heart (the love glow) ------------------------\n  // A warm radial glow centred on the heart, pulsing with the beat + flaring on\n  // the burst. Sampled as a smooth falloff so it reads as light blooming behind\n  // the form, not a hard disc. Warmer (toward uC2) as it goes pop.\n  float glowR = minDim * (0.18 + 0.30 * uGlow) * (1.0 + 0.25 * uBeat);\n  float bloom = exp(-rad / glowR);\n  float bloomAmp = (0.35 + 0.65 * uBeat) * (0.6 + 0.8 * uBurst * (1.0 - uBurst) * 3.0);\n  vec3 glowCol = mix(uC0, uC2, 0.45 + 0.3 * uSaturation);\n  col += glowCol * bloom * bloomAmp * uPresence * uGlow * uExposure * 0.9;\n\n  // ---- HERO HEART ---------------------------------------------------------\n  // The big swelling heart. A rich warm body with a vertical light->shade\n  // gradient (top catches the key light). Photoreal end: smooth gradient + a\n  // tight gloss highlight. Pop end: flatter, more saturated, with a halftone\n  // blush and a crisp rim.\n  // Vertical shading term: 1 at the top of the panel, 0 at the bottom.\n  float vshade = clamp(1.0 - vUv.y, 0.0, 1.0);\n  vec3 bodyLit  = mix(uC1, uC0, 0.35 + 0.65 * uSaturation);          // mid body\n  vec3 bodyHi   = clamp(bodyLit * 1.5 + 0.18, 0.0, 1.6);             // lit top\n  vec3 bodyLow  = bodyLit * 0.55;                                     // shaded base\n  // Photoreal: smooth top->bottom gradient. Cel: snap to two flat zones.\n  float g = smoothstep(0.15, 0.95, vshade);\n  float gCel = step(0.5, vshade);\n  float grad = mix(g, gCel, uStyle);\n  vec3 heartCol = mix(bodyLow, bodyHi, grad);\n\n  // Soft inner-rim self-shadow toward the silhouette so the form reads round\n  // (photoreal); fades out toward the flat cel sticker.\n  // (We approximate the rim from how isolated the fill is via a small blur.)\n  float edge = 0.0;\n  {\n    vec2 px = 1.0 / res;\n    for (int i = 0; i < 6; i++){\n      float a = float(i) / 6.0 * TAU;\n      edge += texture(uPanel, vUv + vec2(cos(a), sin(a)) * px * 3.0).r;\n    }\n    edge /= 6.0;\n  }\n  float rimDark = clamp((heartFill - edge), 0.0, 1.0); // bright near the outline\n  heartCol *= 1.0 - rimDark * 0.5 * (1.0 - uStyle);\n\n  // Halftone blush on the heart toward the pop end (printed sticker shading).\n  float blush = benday(frag, uDotSize, mix(0.35, 0.6, uHalftone), radians(20.0) + uSeed);\n  heartCol += (uC2 - heartCol) * blush * uHalftone * uStyle * 0.28;\n\n  col += heartCol * heartFill * uPresence * uExposure * 1.6;\n\n  // GLOSS: a tight specular highlight near the upper-left of the heart at the\n  // photoreal end (a glassy gel-heart). Seeded by the ink-channel highlight blob\n  // the renderer paints, modulated up by the beat (the heart \"shines\" as it\n  // thumps). Vanishes toward the flat cel end.\n  float gloss = ink * heartFill;          // ink highlight that sits ON the fill\n  float glossAmt = uGloss * (1.0 - uStyle) * (0.6 + 0.6 * uBeat);\n  col += vec3(1.0) * gloss * glossAmt * uPresence * 1.4;\n\n  // ---- BURST: the flurry of little hearts ---------------------------------\n  // Drawn fully in the panel (positions/arc/scale computed in JS for crisp\n  // vector hearts). Here we just light them \u2014 saturated warm fills with a soft\n  // self-glow, fading as they fly out (uBurst late => dimmer).\n  float burstFade = 1.0 - smoothstep(0.55, 1.0, uBurst);\n  vec3 littleCol = mix(uC1, uC2, 0.3 + 0.4 * uSaturation);\n  littleCol = clamp(littleCol * 1.25 + 0.1, 0.0, 1.5);\n  col += littleCol * burstFill * uPresence * burstFade * uExposure * 1.5;\n  // a soft sparkle bloom around the little hearts so they twinkle as they go.\n  col += littleCol * burstFill * 0.4 * burstFade * (0.5 + 0.5 * sin(uTimeS * 30.0 + uSeed));\n\n  // ---- INK / CONTOUR ------------------------------------------------------\n  // Bold outline. On a screen-blend canvas ink is the ABSENCE of light, so the\n  // contour CARVES the lit shapes (reads as a dark outline) \u2014 strongest toward\n  // the flat cel sticker (a clean black keyline), softer at the photoreal end.\n  // The gloss seed (ink ON the fill) is NOT carved (handled above as highlight).\n  float contour = ink * (1.0 - heartFill);  // outline pixels only\n  float carve = contour * uPresence * mix(0.45, 0.95, uStyle);\n  col *= (1.0 - carve);\n\n  // ---- BEAT / BURST FLASH -------------------------------------------------\n  // A warm flash that throws colored light onto the page on each thump and at\n  // the burst. Fast spike (driven by uFlash), warm core.\n  float flashFall = exp(-rad / (minDim * 0.40));\n  vec3 flashCol = mix(uC0, vec3(1.0, 0.85, 0.8), 0.4 + 0.25 * uStyle);\n  col += flashCol * flashFall * uFlash * uExposure * 1.2;\n  // tiny white-hot core at the very centre on the strongest beats.\n  float core = exp(-rad / (minDim * 0.08));\n  col += vec3(1.0, 0.92, 0.9) * core * uFlash * uBeat * 1.3;\n\n  // ---- TONE + FINISH ------------------------------------------------------\n  col = tonemapACES(col * 0.9);\n\n  // Cel posterize toward the pop/sticker end (flat printed color); leaves the\n  // dark page untouched so we don't shatter it.\n  if (uStyle > 0.001) {\n    float lit = smoothstep(0.02, 0.2, max(max(col.r, col.g), col.b));\n    vec3 q = floor(col * 4.0 + 0.5) / 4.0;\n    col = mix(col, mix(col, q, lit), uStyle * 0.7);\n  }\n\n  // Ordered dither to kill banding the screen blend reveals (faded toward cel).\n  col = ditherAdd(col, frag, uTimeS, 1.0 - uStyle * 0.7);\n\n  fragColor = vec4(max(col, 0.0), 1.0);\n}";
+//# sourceMappingURL=heartburst-shader.d.ts.map

package/dist/heartburst-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartburst-shader.d.ts","sourceRoot":"","sources":["../src/heartburst-shader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAWH,eAAO,MAAM,qBAAqB,gMAMhC,CAAC;AAEH,eAAO,MAAM,uBAAuB,gzSAgLlC,CAAC"}

package/dist/heartburst-shader.js

@@ -0,0 +1,214 @@
+/**
+ * GLSL ES 3.00 source for **Heartburst** — Dopamine's love / like / favorite
+ * moment: a heart swells with a double-beat (lub-dub) then BURSTS into a flurry
+ * of small hearts that fly outward, arc, and fade.
+ *
+ * This is a HYBRID (Canvas2D-panel) effect. The crisp vector hearts — the big
+ * hero heart and the little burst hearts — are drawn with a parametric heart
+ * curve into an OFFSCREEN Canvas2D each frame (heartburst-renderer.ts) and
+ * handed to this shader as a single "panel" texture. The shader then does
+ * everything that wants to be procedural / screen-space:
+ *   - a soft warm BLOOM behind the heart (the love glow),
+ *   - a tight GLOSS / specular highlight on the hero heart at the photoreal end,
+ *   - the NOIR ↔ POP styling: a moody near-monochrome heart with one warm spot
+ *     color (noir) → a flat saturated cel "sticker" heart with a hard rim and
+ *     halftone blush (pop), keyed off uStyle/uSaturation,
+ *   - a hot beat FLASH that throws warm light onto the page (the cast).
+ *
+ * Everything is summed as light (canvas is black, composited via
+ * `mix-blend-mode: screen`, so black == no change, bright == cast light).
+ *
+ * Panel texture channel encoding (see heartburst-renderer.ts):
+ *   R = hero heart FILL mask  (the big swelling heart's interior)
+ *   G = INK / contour mask    (heart outline + the gloss seed highlight)
+ *   B = burst hearts FILL     (all the little flying hearts)
+ *   A = unused
+ *
+ * Pure function of uniforms → frame-perfect & cheap under SwiftShader.
+ */
+import { GLSL_CONSTANTS, GLSL_DITHER, GLSL_HALFTONE, GLSL_HASH, GLSL_ROT2, GLSL_TONEMAP_ACES, } from "@dopaminefx/core";
+export const HEARTBURST_VERTEX_SRC = /* glsl */ `#version 300 es
+out vec2 vUv;
+void main() {
+  vec2 pos = vec2(float((gl_VertexID << 1) & 2), float(gl_VertexID & 2));
+  vUv = pos;
+  gl_Position = vec4(pos * 2.0 - 1.0, 0.0, 1.0);
+}`;
+export const HEARTBURST_FRAGMENT_SRC = /* glsl */ `#version 300 es
+precision highp float;
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uPanel;     // R=heartFill G=ink B=burstFill
+uniform vec2  uResolution;    // device pixels
+uniform vec2  uOrigin;        // heart centre (the anchor), device px
+uniform float uLife;          // whole-effect progress 0..1
+uniform float uTimeS;         // elapsed seconds
+uniform float uPresence;      // panel opacity / presence 0..1
+uniform float uBeat;          // 0..1 current beat amplitude (lub-dub thump)
+uniform float uBurst;         // 0..1 burst progress (little hearts flying out)
+uniform float uFlash;         // 0..1 warm beat/burst flash amount
+uniform float uExposure;      // cast-light gain
+uniform float uGlow;          // 0..1 soft bloom radius/strength behind the heart
+uniform float uGloss;         // 0..1 specular gloss on the hero heart (photoreal)
+uniform float uHalftone;      // 0..1 Ben-Day blush dot strength (pop)
+uniform float uDotSize;       // halftone cell size in device px
+uniform float uSaturation;    // 0..1 panel color saturation (noir->pop)
+uniform float uSeed;          // per-fire hash
+uniform float uStyle;         // 0..1 photoreal/noir -> flat cel sticker (whimsy)
+uniform float uShadow;        // 0 = light pass (screen), 1 = shadow pass (multiply)
+uniform vec2  uShadowOffset;  // device-px offset of the cast silhouette
+uniform float uShadowSoft;    // penumbra softness in device px
+uniform float uShadowStrength;// 0..1 max darkening of the multiply layer
+uniform vec3  uC0;            // hero heart core color (warm red)
+uniform vec3  uC1;            // heart shade / burst color (pink/coral)
+uniform vec3  uC2;            // accent / glow / blush color
+
+${GLSL_CONSTANTS}
+${GLSL_HASH}
+${GLSL_ROT2}
+${GLSL_HALFTONE}
+${GLSL_TONEMAP_ACES}
+${GLSL_DITHER}
+
+void main(){
+  vec2 frag = vUv * uResolution;
+  vec2 res = uResolution;
+  float minDim = min(res.x, res.y);
+
+  // ---- SHADOW PASS (multiply layer) ---------------------------------------
+  // Cheap occlusion: the panel's solid forms (hero + burst fills) sampled at an
+  // offset toward the implied key light, with a small ring blur for a penumbra.
+  // White = no shadow (multiply identity); darker = cast shadow. Presence fades
+  // it with the effect.
+  if (uShadow > 0.5) {
+    vec2 px = 1.0 / res;
+    vec2 souv = vUv - uShadowOffset * px;
+    float occ = 0.0;
+    for (int i = 0; i < 8; i++) {
+      float a = float(i) / 8.0 * TAU;
+      vec2 o = vec2(cos(a), sin(a)) * uShadowSoft * px;
+      vec2 tuv = souv + o;
+      vec2 inb = step(vec2(0.0), tuv) * step(tuv, vec2(1.0));
+      float mask = inb.x * inb.y;
+      vec4 s = texture(uPanel, tuv);
+      occ += clamp(s.r + s.b, 0.0, 1.0) * mask;
+    }
+    occ /= 8.0;
+    float dark = clamp(occ * uShadowStrength, 0.0, 1.0);
+    fragColor = vec4(vec3(1.0 - dark), 1.0);
+    return;
+  }
+
+  vec2 fromC = frag - uOrigin;
+  float rad = length(fromC);
+
+  vec4 panel = texture(uPanel, vUv);
+  float heartFill = panel.r;
+  float ink = panel.g;
+  float burstFill = panel.b;
+
+  vec3 col = vec3(0.0);
+
+  // ---- SOFT BLOOM behind the heart (the love glow) ------------------------
+  // A warm radial glow centred on the heart, pulsing with the beat + flaring on
+  // the burst. Sampled as a smooth falloff so it reads as light blooming behind
+  // the form, not a hard disc. Warmer (toward uC2) as it goes pop.
+  float glowR = minDim * (0.18 + 0.30 * uGlow) * (1.0 + 0.25 * uBeat);
+  float bloom = exp(-rad / glowR);
+  float bloomAmp = (0.35 + 0.65 * uBeat) * (0.6 + 0.8 * uBurst * (1.0 - uBurst) * 3.0);
+  vec3 glowCol = mix(uC0, uC2, 0.45 + 0.3 * uSaturation);
+  col += glowCol * bloom * bloomAmp * uPresence * uGlow * uExposure * 0.9;
+
+  // ---- HERO HEART ---------------------------------------------------------
+  // The big swelling heart. A rich warm body with a vertical light->shade
+  // gradient (top catches the key light). Photoreal end: smooth gradient + a
+  // tight gloss highlight. Pop end: flatter, more saturated, with a halftone
+  // blush and a crisp rim.
+  // Vertical shading term: 1 at the top of the panel, 0 at the bottom.
+  float vshade = clamp(1.0 - vUv.y, 0.0, 1.0);
+  vec3 bodyLit  = mix(uC1, uC0, 0.35 + 0.65 * uSaturation);          // mid body
+  vec3 bodyHi   = clamp(bodyLit * 1.5 + 0.18, 0.0, 1.6);             // lit top
+  vec3 bodyLow  = bodyLit * 0.55;                                     // shaded base
+  // Photoreal: smooth top->bottom gradient. Cel: snap to two flat zones.
+  float g = smoothstep(0.15, 0.95, vshade);
+  float gCel = step(0.5, vshade);
+  float grad = mix(g, gCel, uStyle);
+  vec3 heartCol = mix(bodyLow, bodyHi, grad);
+
+  // Soft inner-rim self-shadow toward the silhouette so the form reads round
+  // (photoreal); fades out toward the flat cel sticker.
+  // (We approximate the rim from how isolated the fill is via a small blur.)
+  float edge = 0.0;
+  {
+    vec2 px = 1.0 / res;
+    for (int i = 0; i < 6; i++){
+      float a = float(i) / 6.0 * TAU;
+      edge += texture(uPanel, vUv + vec2(cos(a), sin(a)) * px * 3.0).r;
+    }
+    edge /= 6.0;
+  }
+  float rimDark = clamp((heartFill - edge), 0.0, 1.0); // bright near the outline
+  heartCol *= 1.0 - rimDark * 0.5 * (1.0 - uStyle);
+
+  // Halftone blush on the heart toward the pop end (printed sticker shading).
+  float blush = benday(frag, uDotSize, mix(0.35, 0.6, uHalftone), radians(20.0) + uSeed);
+  heartCol += (uC2 - heartCol) * blush * uHalftone * uStyle * 0.28;
+
+  col += heartCol * heartFill * uPresence * uExposure * 1.6;
+
+  // GLOSS: a tight specular highlight near the upper-left of the heart at the
+  // photoreal end (a glassy gel-heart). Seeded by the ink-channel highlight blob
+  // the renderer paints, modulated up by the beat (the heart "shines" as it
+  // thumps). Vanishes toward the flat cel end.
+  float gloss = ink * heartFill;          // ink highlight that sits ON the fill
+  float glossAmt = uGloss * (1.0 - uStyle) * (0.6 + 0.6 * uBeat);
+  col += vec3(1.0) * gloss * glossAmt * uPresence * 1.4;
+
+  // ---- BURST: the flurry of little hearts ---------------------------------
+  // Drawn fully in the panel (positions/arc/scale computed in JS for crisp
+  // vector hearts). Here we just light them — saturated warm fills with a soft
+  // self-glow, fading as they fly out (uBurst late => dimmer).
+  float burstFade = 1.0 - smoothstep(0.55, 1.0, uBurst);
+  vec3 littleCol = mix(uC1, uC2, 0.3 + 0.4 * uSaturation);
+  littleCol = clamp(littleCol * 1.25 + 0.1, 0.0, 1.5);
+  col += littleCol * burstFill * uPresence * burstFade * uExposure * 1.5;
+  // a soft sparkle bloom around the little hearts so they twinkle as they go.
+  col += littleCol * burstFill * 0.4 * burstFade * (0.5 + 0.5 * sin(uTimeS * 30.0 + uSeed));
+
+  // ---- INK / CONTOUR ------------------------------------------------------
+  // Bold outline. On a screen-blend canvas ink is the ABSENCE of light, so the
+  // contour CARVES the lit shapes (reads as a dark outline) — strongest toward
+  // the flat cel sticker (a clean black keyline), softer at the photoreal end.
+  // The gloss seed (ink ON the fill) is NOT carved (handled above as highlight).
+  float contour = ink * (1.0 - heartFill);  // outline pixels only
+  float carve = contour * uPresence * mix(0.45, 0.95, uStyle);
+  col *= (1.0 - carve);
+
+  // ---- BEAT / BURST FLASH -------------------------------------------------
+  // A warm flash that throws colored light onto the page on each thump and at
+  // the burst. Fast spike (driven by uFlash), warm core.
+  float flashFall = exp(-rad / (minDim * 0.40));
+  vec3 flashCol = mix(uC0, vec3(1.0, 0.85, 0.8), 0.4 + 0.25 * uStyle);
+  col += flashCol * flashFall * uFlash * uExposure * 1.2;
+  // tiny white-hot core at the very centre on the strongest beats.
+  float core = exp(-rad / (minDim * 0.08));
+  col += vec3(1.0, 0.92, 0.9) * core * uFlash * uBeat * 1.3;
+
+  // ---- TONE + FINISH ------------------------------------------------------
+  col = tonemapACES(col * 0.9);
+
+  // Cel posterize toward the pop/sticker end (flat printed color); leaves the
+  // dark page untouched so we don't shatter it.
+  if (uStyle > 0.001) {
+    float lit = smoothstep(0.02, 0.2, max(max(col.r, col.g), col.b));
+    vec3 q = floor(col * 4.0 + 0.5) / 4.0;
+    col = mix(col, mix(col, q, lit), uStyle * 0.7);
+  }
+
+  // Ordered dither to kill banding the screen blend reveals (faded toward cel).
+  col = ditherAdd(col, frag, uTimeS, 1.0 - uStyle * 0.7);
+
+  fragColor = vec4(max(col, 0.0), 1.0);
+}`;
+//# sourceMappingURL=heartburst-shader.js.map

package/dist/heartburst-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartburst-shader.js","sourceRoot":"","sources":["../src/heartburst-shader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EACL,cAAc,EACd,WAAW,EACX,aAAa,EACb,SAAS,EACT,SAAS,EACT,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;;;;;;EAM9C,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BhD,cAAc;EACd,SAAS;EACT,SAAS;EACT,aAAa;EACb,iBAAiB;EACjB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6IX,CAAC"}