@dopaminefx/effect-confetti 0.1.0

package/dist/confetti-renderer.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Confetti Canvas2D PANEL drawing — the PANEL-DRAW SEAM.
+ *
+ * Confetti is a PANEL HYBRID (like comic/heartburst): the paper pieces are
+ * rasterized into an offscreen Canvas2D panel each frame (each pose computed
+ * ONCE per frame, in JS) and the fragment shader (confetti-shader.ts) samples
+ * that texture and applies the screen-space finish (the global gain, ACES
+ * tonemap, cel posterize, ordered dither, soft cast shadow). This is now
+ * CONVERGED across all three platforms: the native ConfettiPanel files
+ * (CoreGraphics / android.graphics) are faithful ports of this draw, the shader
+ * is single-source GLSL, and the factory / tempo / uniforms are GENERATED from
+ * confetti.dope.json. The pieces' MOTION (the ballistic launch-then-fall poses)
+ * is panel GEOMETRY — code by design — so this draw is the ONE hand-written web
+ * source beyond the shader (the per-platform panel-draw seam).
+ *
+ * PERFORMANCE: the original single-pass design re-derived all MAX_PIECES poses
+ * (hash + ballistic + sway + spin) at EVERY pixel — O(pixels × pieces), fine on
+ * a GPU but crawling under software/ANGLE WebGL. The pieces cover a tiny
+ * fraction of the screen, so the work belongs where it scales with COVERED
+ * AREA, not pixel count.
+ *
+ * Panel channel encoding consumed by confetti-shader.ts:
+ *   RGB = the per-piece LIT colour (palette × paper/cel shading), pre-multiplied
+ *         by the piece's lifetime fade and accumulated additively across pieces.
+ *         The shader applies the global gain (amp × exposure), tonemap + finish.
+ */
+import { type PanelDraw, type RGB } from "@dopaminefx/core";
+/** Resolved render params the confetti panel consumes. */
+export interface ConfettiRenderParams {
+    durationMs: number;
+    palette: RGB[];
+    style: number;
+    exposure: number;
+    pieceCount: number;
+    spread: number;
+    launchSpeed: number;
+    gravity: number;
+    flutter: number;
+    pieceSize: number;
+    spin: number;
+    overshoot: number;
+    pieceSeed: number;
+}
+/**
+ * Draw one frame of confetti into the offscreen panel. `life` is whole-effect
+ * progress 0..1; `center` is the launch anchor (device px, canvas y-down).
+ *
+ * Mirrors the original shader's `pieceAt` motion (a mostly-up launch cone, a
+ * gravity arc, an air-drag sway, and a tumbling spin with a face-flash) and its
+ * per-piece lit colour (paper shading ↔ flat cel by whimsy), computed once per
+ * piece in JS instead of once per pixel in GLSL.
+ */
+/**
+ * The per-frame panel draw in the generic `PanelDraw` shape — the ONE
+ * code-shaped hook the data-driven panel factory wires
+ * (`registerDopePanelEffect`). The whole-effect amplitude envelope is DATA
+ * (`tempo.frame.amp` in confetti.dope.json); this draw owns only the pieces'
+ * panel GEOMETRY (the ballistic launch-then-fall poses), which is code by
+ * design. Hands off to {@link drawConfettiPanel}.
+ */
+export declare const drawConfettiFrame: PanelDraw;
+export declare function drawConfettiPanel(ctx: CanvasRenderingContext2D, w: number, h: number, params: ConfettiRenderParams, life: number, center: {
+    x: number;
+    y: number;
+}): void;
+//# sourceMappingURL=confetti-renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confetti-renderer.d.ts","sourceRoot":"","sources":["../src/confetti-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAGxE,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,GAAG,EAAE,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAuBD;;;;;;;;GAQG;AACH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAE/B,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,wBAAwB,EAC7B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,IAAI,CAgGN"}

package/dist/confetti-renderer.js

@@ -0,0 +1,156 @@
+/**
+ * Confetti Canvas2D PANEL drawing — the PANEL-DRAW SEAM.
+ *
+ * Confetti is a PANEL HYBRID (like comic/heartburst): the paper pieces are
+ * rasterized into an offscreen Canvas2D panel each frame (each pose computed
+ * ONCE per frame, in JS) and the fragment shader (confetti-shader.ts) samples
+ * that texture and applies the screen-space finish (the global gain, ACES
+ * tonemap, cel posterize, ordered dither, soft cast shadow). This is now
+ * CONVERGED across all three platforms: the native ConfettiPanel files
+ * (CoreGraphics / android.graphics) are faithful ports of this draw, the shader
+ * is single-source GLSL, and the factory / tempo / uniforms are GENERATED from
+ * confetti.dope.json. The pieces' MOTION (the ballistic launch-then-fall poses)
+ * is panel GEOMETRY — code by design — so this draw is the ONE hand-written web
+ * source beyond the shader (the per-platform panel-draw seam).
+ *
+ * PERFORMANCE: the original single-pass design re-derived all MAX_PIECES poses
+ * (hash + ballistic + sway + spin) at EVERY pixel — O(pixels × pieces), fine on
+ * a GPU but crawling under software/ANGLE WebGL. The pieces cover a tiny
+ * fraction of the screen, so the work belongs where it scales with COVERED
+ * AREA, not pixel count.
+ *
+ * Panel channel encoding consumed by confetti-shader.ts:
+ *   RGB = the per-piece LIT colour (palette × paper/cel shading), pre-multiplied
+ *         by the piece's lifetime fade and accumulated additively across pieces.
+ *         The shader applies the global gain (amp × exposure), tonemap + finish.
+ */
+import { mulberry32 } from "@dopaminefx/core";
+import { MAX_PIECES } from "./confetti-shader.js";
+const TAU = Math.PI * 2;
+const clamp01 = (x) => (x < 0 ? 0 : x > 1 ? 1 : x);
+const mix = (a, b, t) => a + (b - a) * t;
+const fract = (x) => x - Math.floor(x);
+const smoothstep = (e0, e1, x) => {
+    const t = clamp01((x - e0) / (e1 - e0));
+    return t * t * (3 - 2 * t);
+};
+/** paletteMix from the look lib: two-segment lerp across the three stops. */
+function paletteMix(pal, t) {
+    t = clamp01(t);
+    const [c0, c1, c2] = pal;
+    if (t < 0.5) {
+        const k = t * 2;
+        return { r: mix(c0.r, c1.r, k), g: mix(c0.g, c1.g, k), b: mix(c0.b, c1.b, k) };
+    }
+    const k = (t - 0.5) * 2;
+    return { r: mix(c1.r, c2.r, k), g: mix(c1.g, c2.g, k), b: mix(c1.b, c2.b, k) };
+}
+/**
+ * Draw one frame of confetti into the offscreen panel. `life` is whole-effect
+ * progress 0..1; `center` is the launch anchor (device px, canvas y-down).
+ *
+ * Mirrors the original shader's `pieceAt` motion (a mostly-up launch cone, a
+ * gravity arc, an air-drag sway, and a tumbling spin with a face-flash) and its
+ * per-piece lit colour (paper shading ↔ flat cel by whimsy), computed once per
+ * piece in JS instead of once per pixel in GLSL.
+ */
+/**
+ * The per-frame panel draw in the generic `PanelDraw` shape — the ONE
+ * code-shaped hook the data-driven panel factory wires
+ * (`registerDopePanelEffect`). The whole-effect amplitude envelope is DATA
+ * (`tempo.frame.amp` in confetti.dope.json); this draw owns only the pieces'
+ * panel GEOMETRY (the ballistic launch-then-fall poses), which is code by
+ * design. Hands off to {@link drawConfettiPanel}.
+ */
+export const drawConfettiFrame = (pctx, w, h, params, info) => {
+    drawConfettiPanel(pctx, w, h, params, info.life, info.centerPx);
+};
+export function drawConfettiPanel(ctx, w, h, params, life, center) {
+    ctx.clearRect(0, 0, w, h);
+    if (life <= 0 || life >= 1)
+        return;
+    const minDim = Math.min(w, h);
+    const count = Math.max(0, Math.min(MAX_PIECES, Math.round(params.pieceCount)));
+    const rng = mulberry32(((params.pieceSeed * 1000) >>> 0) + 1);
+    const style = params.style;
+    ctx.save();
+    ctx.globalCompositeOperation = "lighter"; // additive accumulation, like the shader's `col +=`
+    for (let i = 0; i < count; i++) {
+        // Five per-piece randoms in a fixed order (≈ the GLSL hash21/hash11 draws).
+        const hx = rng(), hy = rng(), h2x = rng(), h2y = rng(), h3 = rng();
+        // Spawn stagger: most pieces fire in the first ~12%, renormalized to a full arc.
+        const delay = h2x * 0.12;
+        const pl = clamp01((life - delay) / (1 - delay));
+        if (pl <= 0 || pl >= 1)
+            continue;
+        // Launch direction (y-up local frame): a mostly-up cone fanned by spread.
+        const fan = (hx - 0.5) * 2;
+        const dlen = Math.hypot(fan * (0.35 + params.spread), 1.0);
+        const dirx = (fan * (0.35 + params.spread)) / dlen;
+        const diry = 1.0 / dlen;
+        const speed = (0.85 + hy * 0.6) * params.launchSpeed * minDim * 1.15;
+        const grav = (0.9 + h3 * 0.4) * params.gravity * minDim * 1.5;
+        // Ballistic arc: up, then down under gravity (y-up).
+        let px = dirx * speed * pl;
+        let py = diry * speed * pl - grav * pl * pl;
+        // Air-drag flutter: a growing sideways sway as the piece slows + falls.
+        const swayPhase = hx * TAU + h2y * 3.0;
+        const swayFreq = 3.0 + h2x * 4.0;
+        const fallT = smoothstep(0.12, 0.7, pl);
+        const swayAmp = params.flutter * minDim * 0.06 * (0.4 + fallT);
+        const sway = Math.sin(pl * swayFreq + swayPhase) * swayAmp +
+            Math.sin(pl * swayFreq * 0.37 + swayPhase * 1.7) * swayAmp * 0.4;
+        px += sway;
+        // Spin + face-flash (wide/bright face-on, dim edge-on).
+        const spinRate = (3.0 + h3 * 6.0) * params.spin;
+        const rot = pl * spinRate * TAU + swayPhase;
+        const flip = Math.abs(Math.cos(rot * 0.5 + sway * 0.02));
+        const face = mix(0.18, 1.0, flip);
+        // Paper shape: rectangles + a few petals, foreshortened by the face angle.
+        const aspect = mix(0.5, 1.6, h2y);
+        const s = minDim * 0.011 * params.pieceSize * (0.7 + hy * 0.7);
+        const fore = mix(1.0, face, 0.65);
+        const heX = Math.max(s * aspect * fore, 0.5);
+        const heY = Math.max(s * fore, 0.5);
+        const hue = fract(h2y * 0.9 + h3 * 0.31);
+        const petal = h3 >= 0.78;
+        // Per-piece lit colour (paper shading ↔ flat cel), pre-multiplied by fade.
+        const base = paletteMix(params.palette, hue);
+        const shade = mix(0.45, 1.15, face);
+        const spec = smoothstep(0.85, 1.0, face) * 0.5;
+        const celK = face >= 0.5 ? 1 : 0;
+        const celShade = mix(0.55, 1.1, celK);
+        const fade = (1 - Math.pow(pl, 1.4)) * smoothstep(0.0, 0.08, pl);
+        const lit = (c) => {
+            const paper = c * shade + spec;
+            const cel = c * celShade;
+            return clamp01(mix(paper, cel, style)) * fade;
+        };
+        const r = Math.round(lit(base.r) * 255);
+        const g = Math.round(lit(base.g) * 255);
+        const bl = Math.round(lit(base.b) * 255);
+        if (r + g + bl <= 0)
+            continue;
+        // Place in canvas space (flip y: local y-up → canvas y-down).
+        const cx = center.x + px;
+        const cy = center.y - py;
+        ctx.save();
+        ctx.translate(cx, cy);
+        ctx.rotate(rot);
+        ctx.fillStyle = `rgb(${r},${g},${bl})`;
+        if (petal) {
+            ctx.beginPath();
+            ctx.ellipse(0, 0, heX * 1.05, heY * 1.05, 0, 0, TAU);
+            ctx.fill();
+        }
+        else {
+            const rad = Math.min(heX, heY) * 0.5;
+            ctx.beginPath();
+            ctx.roundRect(-heX, -heY, heX * 2, heY * 2, rad);
+            ctx.fill();
+        }
+        ctx.restore();
+    }
+    ctx.restore();
+}
+//# sourceMappingURL=confetti-renderer.js.map

package/dist/confetti-renderer.js.map

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

package/dist/confetti-shader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * GLSL ES 3.00 source for Confetti (web, PANEL architecture).
+ *
+ * The paper pieces are rasterized into an offscreen Canvas2D panel each frame
+ * (see confetti-renderer.ts) — each piece's pose + lit colour computed ONCE in JS
+ * rather than re-derived at every pixel. This shader is now a cheap O(pixels)
+ * pass: it SAMPLES that panel and applies only the screen-space finish that wants
+ * to be procedural —
+ *   - the global gain (envelope amp × exposure) + filmic ACES tonemap so dense
+ *     bursts roll off gracefully on the screen-blend page,
+ *   - the cel posterize / saturation punch toward the whimsy (cel) end,
+ *   - an ordered dither to kill screen-blend banding,
+ *   - and a cheap soft drop-shadow on the multiply pass (a ring-blurred sample of
+ *     the panel's mass, offset toward the implied light).
+ *
+ * Why: the old single-pass design looped MAX_PIECES at every fragment
+ * (O(pixels × pieces)) which is fine on a GPU but crawls under software/ANGLE
+ * WebGL. Sampling a pre-rasterized panel makes the per-pixel cost independent of
+ * piece count. Mirrors the comic/heartburst hybrid effects. (The Swift/Metal
+ * confetti keeps its analytic GPU pass — this change is web-only; the .dope is
+ * unchanged across platforms.)
+ */
+/**
+ * Max confetti pieces. Single source of truth: BOTH the panel renderer's loop
+ * bound and the integer-clamp const the `.dope` mapping references (passed to the
+ * loader as `MAX_PIECES`). Counts above this won't render.
+ */
+export declare const MAX_PIECES = 120;
+export declare const CONFETTI_VERTEX_SRC = "#version 300 es\nout vec2 vUv;\nvoid main() {\n  // Single full-screen triangle from gl_VertexID \u2014 no vertex buffers needed.\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 CONFETTI_FRAGMENT_SRC = "#version 300 es\nprecision highp float;\nin vec2 vUv;\nout vec4 fragColor;\n\nuniform sampler2D uPanel;     // RGB = accumulated per-piece lit colour \u00D7 fade\nuniform vec2  uResolution;    // device pixels\nuniform float uAmp;           // envelope amplitude (peaks > 1) \u2014 overall brightness\nuniform float uTimeS;         // elapsed seconds (snapped \"on twos\" with style)\nuniform float uExposure;\nuniform float uStyle;         // 0..1 photoreal paper -> flat cel shapes\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 (blur tap radius)\nuniform float uShadowStrength;// 0..1 max darkening of the multiply layer\nuniform vec3  uC0;\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\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\n  // ---- SHADOW pass (multiply layer) --------------------------------------\n  // A cheap soft drop-shadow: ring-blur the panel's mass at a sample point pushed\n  // against the light offset. White = no shadow; darker = cast silhouette.\n  if (uShadow > 0.5) {\n    vec2 px = 1.0 / uResolution;\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      vec3 s = texture(uPanel, tuv).rgb;\n      occ += (s.r + s.g + s.b) * (1.0 / 3.0) * inb.x * inb.y;\n    }\n    occ /= 8.0;\n    float dark = clamp(occ * uAmp, 0.0, 1.0) * uShadowStrength;\n    vec3 tint = mix(vec3(1.0), 0.6 + 0.4 * normalize(uC0 + 1e-3), 0.2);\n    vec3 mul = mix(vec3(1.0), tint, dark);\n    fragColor = vec4(mul, 1.0);\n    return;\n  }\n\n  // ---- LIGHT pass --------------------------------------------------------\n  // The panel already holds \u03A3(lit \u00D7 fade) per piece; apply the global gain, then\n  // the same filmic + cel + dither finish the original single-pass shader did.\n  vec3 col = texture(uPanel, vUv).rgb * (uAmp * uExposure) * 1.35;\n\n  col = tonemapACES(col * 0.85);\n\n  // Cel posterize at the whimsy end: punch saturation + quantize into hard bands.\n  if (uStyle > 0.001) {\n    float l = dot(col, vec3(0.299, 0.587, 0.114));\n    vec3 neon = clamp(l + (col - l) * 1.5, 0.0, 1.0);\n    vec3 styled = mix(col, neon, 0.65);\n    float bands = mix(40.0, 5.0, uStyle);\n    styled = floor(styled * bands + 0.5) / bands;\n    col = mix(col, styled, uStyle);\n  }\n\n  // Ordered dither to break screen-blend banding; faded toward the cel end.\n  col = ditherAdd(col, frag, uTimeS, 1.0 - uStyle);\n\n  fragColor = vec4(col, 1.0);\n}";
+//# sourceMappingURL=confetti-shader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confetti-shader.d.ts","sourceRoot":"","sources":["../src/confetti-shader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH;;;;GAIG;AACH,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,eAAO,MAAM,mBAAmB,oRAO9B,CAAC;AAEH,eAAO,MAAM,qBAAqB,mzGAqEhC,CAAC"}

package/dist/confetti-shader.js

@@ -0,0 +1,108 @@
+/**
+ * GLSL ES 3.00 source for Confetti (web, PANEL architecture).
+ *
+ * The paper pieces are rasterized into an offscreen Canvas2D panel each frame
+ * (see confetti-renderer.ts) — each piece's pose + lit colour computed ONCE in JS
+ * rather than re-derived at every pixel. This shader is now a cheap O(pixels)
+ * pass: it SAMPLES that panel and applies only the screen-space finish that wants
+ * to be procedural —
+ *   - the global gain (envelope amp × exposure) + filmic ACES tonemap so dense
+ *     bursts roll off gracefully on the screen-blend page,
+ *   - the cel posterize / saturation punch toward the whimsy (cel) end,
+ *   - an ordered dither to kill screen-blend banding,
+ *   - and a cheap soft drop-shadow on the multiply pass (a ring-blurred sample of
+ *     the panel's mass, offset toward the implied light).
+ *
+ * Why: the old single-pass design looped MAX_PIECES at every fragment
+ * (O(pixels × pieces)) which is fine on a GPU but crawls under software/ANGLE
+ * WebGL. Sampling a pre-rasterized panel makes the per-pixel cost independent of
+ * piece count. Mirrors the comic/heartburst hybrid effects. (The Swift/Metal
+ * confetti keeps its analytic GPU pass — this change is web-only; the .dope is
+ * unchanged across platforms.)
+ */
+import { GLSL_CONSTANTS, GLSL_DITHER, GLSL_HASH, GLSL_TONEMAP_ACES, } from "@dopaminefx/core";
+/**
+ * Max confetti pieces. Single source of truth: BOTH the panel renderer's loop
+ * bound and the integer-clamp const the `.dope` mapping references (passed to the
+ * loader as `MAX_PIECES`). Counts above this won't render.
+ */
+export const MAX_PIECES = 120;
+export const CONFETTI_VERTEX_SRC = /* glsl */ `#version 300 es
+out vec2 vUv;
+void main() {
+  // Single full-screen triangle from gl_VertexID — no vertex buffers needed.
+  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 CONFETTI_FRAGMENT_SRC = /* glsl */ `#version 300 es
+precision highp float;
+in vec2 vUv;
+out vec4 fragColor;
+
+uniform sampler2D uPanel;     // RGB = accumulated per-piece lit colour × fade
+uniform vec2  uResolution;    // device pixels
+uniform float uAmp;           // envelope amplitude (peaks > 1) — overall brightness
+uniform float uTimeS;         // elapsed seconds (snapped "on twos" with style)
+uniform float uExposure;
+uniform float uStyle;         // 0..1 photoreal paper -> flat cel shapes
+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 (blur tap radius)
+uniform float uShadowStrength;// 0..1 max darkening of the multiply layer
+uniform vec3  uC0;
+
+${GLSL_CONSTANTS}
+${GLSL_HASH}
+${GLSL_TONEMAP_ACES}
+${GLSL_DITHER}
+
+void main() {
+  vec2 frag = vUv * uResolution;
+
+  // ---- SHADOW pass (multiply layer) --------------------------------------
+  // A cheap soft drop-shadow: ring-blur the panel's mass at a sample point pushed
+  // against the light offset. White = no shadow; darker = cast silhouette.
+  if (uShadow > 0.5) {
+    vec2 px = 1.0 / uResolution;
+    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));
+      vec3 s = texture(uPanel, tuv).rgb;
+      occ += (s.r + s.g + s.b) * (1.0 / 3.0) * inb.x * inb.y;
+    }
+    occ /= 8.0;
+    float dark = clamp(occ * uAmp, 0.0, 1.0) * uShadowStrength;
+    vec3 tint = mix(vec3(1.0), 0.6 + 0.4 * normalize(uC0 + 1e-3), 0.2);
+    vec3 mul = mix(vec3(1.0), tint, dark);
+    fragColor = vec4(mul, 1.0);
+    return;
+  }
+
+  // ---- LIGHT pass --------------------------------------------------------
+  // The panel already holds Σ(lit × fade) per piece; apply the global gain, then
+  // the same filmic + cel + dither finish the original single-pass shader did.
+  vec3 col = texture(uPanel, vUv).rgb * (uAmp * uExposure) * 1.35;
+
+  col = tonemapACES(col * 0.85);
+
+  // Cel posterize at the whimsy end: punch saturation + quantize into hard bands.
+  if (uStyle > 0.001) {
+    float l = dot(col, vec3(0.299, 0.587, 0.114));
+    vec3 neon = clamp(l + (col - l) * 1.5, 0.0, 1.0);
+    vec3 styled = mix(col, neon, 0.65);
+    float bands = mix(40.0, 5.0, uStyle);
+    styled = floor(styled * bands + 0.5) / bands;
+    col = mix(col, styled, uStyle);
+  }
+
+  // Ordered dither to break screen-blend banding; faded toward the cel end.
+  col = ditherAdd(col, frag, uTimeS, 1.0 - uStyle);
+
+  fragColor = vec4(col, 1.0);
+}`;
+//# sourceMappingURL=confetti-shader.js.map

package/dist/confetti-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confetti-shader.js","sourceRoot":"","sources":["../src/confetti-shader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,cAAc,EACd,WAAW,EACX,SAAS,EACT,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,CAAC;AAE9B,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAC;;;;;;;EAO5C,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;EAiB9C,cAAc;EACd,SAAS;EACT,iBAAiB;EACjB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiDX,CAAC"}

package/dist/confetti-tempo.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Confetti's bespoke timing — the launch-then-fall amplitude envelope.
+ *
+ * Unlike the success effects' held-breath `envelope` (which decays from its
+ * early peak), confetti stays BRIGHT through the long fall — per-piece
+ * `particleFade` in the shader handles each piece dimming as it lands. So this
+ * is a sharp POP attack (overshoot at launch), a near-full sustain while
+ * everything falls, then a gentle fade only at the very end as the last pieces
+ * settle. Built on the generic `easeOutBack`/`easeOutCubic` primitives.
+ */
+/** Confetti launch-then-fall amplitude over normalized life. Peak > 1 at launch. */
+export declare function confettiAmp(life: number, overshoot: number): number;
+//# sourceMappingURL=confetti-tempo.d.ts.map

package/dist/confetti-tempo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confetti-tempo.d.ts","sourceRoot":"","sources":["../src/confetti-tempo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAYnE"}

package/dist/confetti-tempo.js

@@ -0,0 +1,28 @@
+/**
+ * Confetti's bespoke timing — the launch-then-fall amplitude envelope.
+ *
+ * Unlike the success effects' held-breath `envelope` (which decays from its
+ * early peak), confetti stays BRIGHT through the long fall — per-piece
+ * `particleFade` in the shader handles each piece dimming as it lands. So this
+ * is a sharp POP attack (overshoot at launch), a near-full sustain while
+ * everything falls, then a gentle fade only at the very end as the last pieces
+ * settle. Built on the generic `easeOutBack`/`easeOutCubic` primitives.
+ */
+import { easeOutBack, easeOutCubic } from "@dopaminefx/core";
+/** Confetti launch-then-fall amplitude over normalized life. Peak > 1 at launch. */
+export function confettiAmp(life, overshoot) {
+    if (life <= 0 || life >= 1)
+        return 0;
+    const attack = 0.12;
+    if (life < attack) {
+        // Sharp pop with a little overshoot (the burst leaving the action).
+        return easeOutBack(life / attack, overshoot);
+    }
+    // Long luminous sustain, then a soft fade over the last ~30% as pieces settle.
+    const tailStart = 0.7;
+    if (life < tailStart)
+        return 1;
+    const x = (life - tailStart) / (1 - tailStart);
+    return 1 - easeOutCubic(x) * 0.85;
+}
+//# sourceMappingURL=confetti-tempo.js.map

package/dist/confetti-tempo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confetti-tempo.js","sourceRoot":"","sources":["../src/confetti-tempo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE7D,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAAiB;IACzD,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;QAClB,oEAAoE;QACpE,OAAO,WAAW,CAAC,IAAI,GAAG,MAAM,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IACD,+EAA+E;IAC/E,MAAM,SAAS,GAAG,GAAG,CAAC;IACtB,IAAI,IAAI,GAAG,SAAS;QAAE,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,GAAG,CAAC,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AACpC,CAAC"}