@dopaminefx/core 0.1.0

package/dist/framework/pass-runner.js

@@ -0,0 +1,212 @@
+/**
+ * Generic fullscreen-pass runner — the shared backbone for PURE-SHADER effects.
+ *
+ * A pure-shader effect (Solarbloom, Calligraphic Verdict, the Fail stamp) is a
+ * full-screen triangle that runs a fragment shader twice — once into the light
+ * (screen) context and, when present, once into the shadow (multiply) context.
+ * Before this runner, each effect hand-wired the SAME plumbing: link/bind the
+ * program + VAO, set the standard uniforms (resolution, origin, time, life,
+ * envelope amp, palette, style, the shadow-pass uniforms), upload + bind any aux
+ * textures (a baked SDF icon) into BOTH contexts, run the two passes, and free
+ * the per-fire GPU resources. That ~120 lines of identical glue is now here,
+ * once.
+ *
+ * What stays per-effect (the honest boundary): the GLSL itself, and a tiny
+ * `frame()` hook that computes the genuinely effect-specific TIME-VARYING values
+ * (which envelope, which confirm/draw/stamp progress, any shake) into named
+ * uniforms. Everything else — standard uniforms, scalar `render.params` →
+ * `u<Name>` auto-binding, aux-texture upload/bind, the light+shadow loop, the
+ * "animate on twos" stepping, dispose — is generic and data-driven from a small
+ * config object.
+ *
+ * The output is byte-identical to the bespoke renderers it replaces: it sets the
+ * same uniforms, in a superset that the shader samples by name, and uses the same
+ * `shadowGeometry` / envelope / progress math (supplied by the config).
+ */
+import { NPR_TIME_STEP_MS } from "../engine/tempo.js";
+import { STANDARD_COMMON, allocTexture, applyFloatMap, beginProgram, bindFrameUniforms, bindPalette, bindScalars, bindShadowGeometry, bindTarget, compositeLightFragment, computeScalarBinds, resolveTargetPx, } from "./pass-common.js";
+// The pure-shader runner adds `uOrigin` (anchored radial effects) to the shared
+// standard set.
+const STANDARD = ["uOrigin", ...STANDARD_COMMON];
+/** Upload a decoded SDF as a single-channel R8 texture (FLIP_Y, edge-clamped). */
+function uploadSdf(glc, sdf) {
+    const { gl } = glc;
+    const tex = gl.createTexture();
+    gl.bindTexture(gl.TEXTURE_2D, tex);
+    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
+    gl.pixelStorei(gl.UNPACK_ALIGNMENT, 1);
+    gl.texImage2D(gl.TEXTURE_2D, 0, gl.R8, sdf.size, sdf.size, 0, gl.RED, gl.UNSIGNED_BYTE, sdf.bytes);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+    gl.texParameteri(gl.TEXTURE_2D, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
+    return tex;
+}
+/**
+ * Build a drawable {@link EffectInstance} for a pure-shader effect from its
+ * config + resolved params + the runtime context. This is the `create()` an
+ * effect (or a registered program) hands to the conductor.
+ */
+export function createPassInstance(config, params, ctx) {
+    const pal = params.palette;
+    const dpr = ctx.dpr;
+    const panelCfg = config.panel;
+    // In backdrop-aware mode the LIGHT pass emits premultiplied light (alpha =
+    // brightness) so it composites source-over and stays visible on any surface;
+    // the SHADOW pass keeps the original opaque fragment for its multiply blend.
+    const lightFragment = ctx.composite?.premultiplied
+        ? compositeLightFragment(config.fragment)
+        : config.fragment;
+    const allUniforms = [
+        ...new Set([...STANDARD, ...config.uniforms, ...(panelCfg ? [panelCfg.sampler] : [])]),
+    ];
+    // Optional dynamic sprite panel (drawn once per frame, uploaded to both passes).
+    const panelCanvas = panelCfg ? document.createElement("canvas") : null;
+    const panelCtx2d = panelCanvas ? panelCanvas.getContext("2d", { alpha: true }) : null;
+    const panelTexLight = panelCfg ? allocTexture(ctx.light) : null;
+    const panelTexShadow = panelCfg && ctx.shadow ? allocTexture(ctx.shadow) : null;
+    // The numeric params that auto-bind to a uniform: `name → u<Name>` unless an
+    // explicit binding overrides it (or maps it to null to skip).
+    const scalarBinds = computeScalarBinds(params, config.bindings ?? {});
+    // Aux textures. SDF sources upload up front (static R8 data); canvas sources
+    // allocate the texture now but upload pixels lazily on first bind (the canvas
+    // may still be drawn after create()).
+    const auxSpecs = config.auxTextures?.(params, ctx) ?? [];
+    const uploaded = new WeakSet();
+    const aux = auxSpecs.map((spec) => {
+        if (spec.kind === "sdf") {
+            return { spec, light: uploadSdf(ctx.light, spec.sdf), shadow: ctx.shadow ? uploadSdf(ctx.shadow, spec.sdf) : null };
+        }
+        return { spec, light: allocTexture(ctx.light), shadow: ctx.shadow ? allocTexture(ctx.shadow) : null };
+    });
+    const heightFrac = () => typeof config.shadowHeightFrac === "function" ? config.shadowHeightFrac(params) : config.shadowHeightFrac;
+    const bindFrameArrays = (gl, u, arrays) => {
+        if (!arrays)
+            return;
+        for (const a of arrays) {
+            const loc = u[a.name];
+            if (!loc)
+                continue;
+            if (a.size === 2)
+                gl.uniform2fv(loc, a.data);
+            else if (a.size === 3)
+                gl.uniform3fv(loc, a.data);
+            else
+                gl.uniform4fv(loc, a.data);
+        }
+    };
+    const drawPass = (glc, info, frameUniforms, isShadow, frameArrs) => {
+        const { gl } = glc;
+        const c = glc.canvas;
+        const { u } = beginProgram(glc, config.vertex, isShadow ? config.fragment : lightFragment, allUniforms);
+        // Aux textures (baked SDF icons / rasterized canvas glyphs).
+        for (const a of aux) {
+            const tex = isShadow ? a.shadow : a.light;
+            if (tex) {
+                gl.activeTexture(gl.TEXTURE0 + a.spec.unit);
+                gl.bindTexture(gl.TEXTURE_2D, tex);
+                // Canvas sources upload their pixels lazily, once per texture.
+                if (a.spec.kind === "canvas" && !uploaded.has(tex)) {
+                    gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
+                    gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, false);
+                    gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, a.spec.source);
+                    uploaded.add(tex);
+                }
+                const loc = u[a.spec.sampler];
+                if (loc)
+                    gl.uniform1i(loc, a.spec.unit);
+            }
+            if (a.spec.onUniform && u[a.spec.onUniform])
+                gl.uniform1f(u[a.spec.onUniform], tex ? 1 : 0);
+            applyFloatMap(gl, u, a.spec.uniforms?.(c, params));
+        }
+        // Dynamic sprite panel (drawn this frame in renderAt): upload + bind here.
+        if (panelCfg && panelCanvas) {
+            const tex = isShadow ? panelTexShadow : panelTexLight;
+            if (tex) {
+                gl.activeTexture(gl.TEXTURE0 + panelCfg.unit);
+                gl.bindTexture(gl.TEXTURE_2D, tex);
+                gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, true);
+                gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, false);
+                gl.texImage2D(gl.TEXTURE_2D, 0, gl.RGBA, gl.RGBA, gl.UNSIGNED_BYTE, panelCanvas);
+                gl.pixelStorei(gl.UNPACK_FLIP_Y_WEBGL, false);
+                if (u[panelCfg.sampler])
+                    gl.uniform1i(u[panelCfg.sampler], panelCfg.unit);
+            }
+        }
+        // Extra per-pass scalar uniforms (canvas/target-size-dependent, non-aux).
+        applyFloatMap(gl, u, config.passUniforms?.(c, params, resolveTargetPx(c, ctx.targetSize, dpr), dpr));
+        // Standard uniforms.
+        gl.uniform2f(u.uResolution, c.width, c.height);
+        bindTarget(gl, u, c, ctx.targetSize, dpr);
+        if (config.usesOrigin && u.uOrigin) {
+            // gl_FragCoord origin is bottom-left, so flip the anchor's y.
+            gl.uniform2f(u.uOrigin, ctx.anchor.x * dpr, c.height - ctx.anchor.y * dpr);
+        }
+        gl.uniform1f(u.uLife, info.life);
+        gl.uniform1f(u.uTimeS, info.animMs / 1000);
+        if (config.loopPeriodMs) {
+            // Standard periodic clocks for a looping effect, off the SAME snapped
+            // clock as uTimeS (so the on-twos seam guarantee carries over).
+            const loopMs = info.animMs % config.loopPeriodMs;
+            gl.uniform1f(u.uLoopS, loopMs / 1000);
+            gl.uniform1f(u.uPhase, loopMs / config.loopPeriodMs);
+        }
+        gl.uniform1f(u.uStyle, params.style);
+        bindPalette(gl, u, pal);
+        bindScalars(gl, u, params, scalarBinds);
+        bindFrameUniforms(gl, u, frameUniforms);
+        bindFrameArrays(gl, u, frameArrs);
+        gl.uniform1f(u.uShadow, isShadow ? 1 : 0);
+        if (isShadow)
+            bindShadowGeometry(gl, u, c, heightFrac(), frameUniforms.amp, params.style);
+        gl.drawArrays(gl.TRIANGLES, 0, 3);
+    };
+    let disposed = false;
+    return {
+        durationMs: params.durationMs,
+        renderAt(elapsedMs) {
+            if (disposed)
+                return;
+            // "Animate on twos": snap the clock toward a coarse grid as style rises.
+            const stepped = Math.floor(elapsedMs / NPR_TIME_STEP_MS) * NPR_TIME_STEP_MS;
+            const animMs = elapsedMs + (stepped - elapsedMs) * params.style;
+            const life = Math.min(Math.max(animMs, 0) / params.durationMs, 1);
+            const info = { animMs, life, elapsedMs };
+            const frameUniforms = config.frame(info, params);
+            // Draw the dynamic sprite panel once (shared by both passes), if present.
+            if (panelCfg && panelCanvas && panelCtx2d) {
+                const c = ctx.light.canvas;
+                if (panelCanvas.width !== c.width || panelCanvas.height !== c.height) {
+                    panelCanvas.width = c.width;
+                    panelCanvas.height = c.height;
+                }
+                const centerPx = { x: ctx.anchor.x * dpr, y: ctx.anchor.y * dpr };
+                panelCfg.draw(panelCtx2d, c.width, c.height, params, { ...info, centerPx, dpr });
+            }
+            // Per-frame array uniforms (CPU-precomputed geometry), computed once.
+            const c = ctx.light.canvas;
+            const origin = { x: ctx.anchor.x * dpr, y: c.height - ctx.anchor.y * dpr };
+            const frameArrs = config.frameArrays?.(info, params, { width: c.width, height: c.height, dpr, origin });
+            if (ctx.shadow)
+                drawPass(ctx.shadow, info, frameUniforms, true, frameArrs);
+            drawPass(ctx.light, info, frameUniforms, false, frameArrs);
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const a of aux) {
+                ctx.light.gl.deleteTexture(a.light);
+                if (a.shadow && ctx.shadow)
+                    ctx.shadow.gl.deleteTexture(a.shadow);
+            }
+            if (panelTexLight)
+                ctx.light.gl.deleteTexture(panelTexLight);
+            if (panelTexShadow && ctx.shadow)
+                ctx.shadow.gl.deleteTexture(panelTexShadow);
+        },
+    };
+}
+//# sourceMappingURL=pass-runner.js.map

package/dist/framework/pass-runner.js.map

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

package/dist/framework/programs.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Render-program registry — the seam that makes `loadEffect()` real.
+ *
+ * A `.dope` is renderer-agnostic data, but it references a SHADER PROGRAM by key
+ * (`render.backends.webgl2.shader.program`, e.g. "solarbloom"). The runtime ships
+ * a small set of bundled programs; each is a `create(params, ctx)` renderer (the
+ * GLSL body + uniform plumbing) plus the metadata the loader needs to resolve the
+ * `.dope` into that renderer's params: the per-fire scatter key (moteSeed /
+ * inkSeed / …), the integer-clamp consts (MAX_MOTES / MAX_DROPS), whether it
+ * casts a shadow, and its reduced-motion peak.
+ *
+ * Built-in effects register their renderer here (in addition to registering
+ * themselves as an `EffectFactory`), so `loadEffect(anyDopeDoc)` can bind an
+ * arbitrary, host-authored `.dope` to a bundled program with NO new code — the
+ * whole point of the format. This is "the format references shader bodies; it is
+ * not a transpiler" made concrete: the doc carries data + a program key; the
+ * runtime owns the GLSL the key resolves to.
+ */
+import type { EffectContext, EffectInstance } from "./effect.js";
+/** A bundled renderer + the metadata the loader needs to feed it from a `.dope`. */
+export interface RenderProgram<Params = Record<string, unknown>> {
+    /** Build a drawable instance from resolved params (same shape as EffectFactory.create). */
+    create(params: Params, ctx: EffectContext): EffectInstance;
+    /** The per-fire scatter-offset key this renderer reads (moteSeed / inkSeed / …). */
+    scatterKey: string;
+    /** Integer-clamp constants referenced by the `.dope` mapping (MAX_MOTES, …). */
+    consts: Record<string, number>;
+    /** Whether the renderer wants a shadow (multiply) companion canvas. Default true. */
+    castsShadow?: boolean;
+    /** Reduced-motion peak/hold (ms). */
+    reducedMotion?: {
+        holdMs?: number;
+        peakMs?: number;
+    };
+    /**
+     * Optional hook to compose NON-numeric, code-shaped params on top of the
+     * loader's numeric/palette bag (e.g. Solarbloom's whimsy-picked check glyph,
+     * Comic's word + typography). Pure; receives the feeling. Most data-driven
+     * effects (incl. the fail effect) need none.
+     */
+    composeParams?(numeric: Record<string, unknown>, feeling: {
+        mood: string;
+        intensity: number;
+        whimsy: number;
+        seed: number;
+    }): Record<string, unknown>;
+}
+/** Register (or override) a bundled render program by key. */
+export declare function registerProgram<P>(name: string, program: RenderProgram<P>): RenderProgram<P>;
+/** Look up a bundled render program by key. */
+export declare function getProgram(name: string): RenderProgram | undefined;
+/** Names of all registered render programs. */
+export declare function programNames(): string[];
+//# sourceMappingURL=programs.d.ts.map

package/dist/framework/programs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.d.ts","sourceRoot":"","sources":["../../src/framework/programs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE,oFAAoF;AACpF,MAAM,WAAW,aAAa,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,2FAA2F;IAC3F,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,cAAc,CAAC;IAC3D,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qFAAqF;IACrF,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qCAAqC;IACrC,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD;;;;;OAKG;IACH,aAAa,CAAC,CACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GACzE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5B;AAID,8DAA8D;AAC9D,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAG5F;AAED,+CAA+C;AAC/C,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAElE;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC"}

package/dist/framework/programs.js

@@ -0,0 +1,33 @@
+/**
+ * Render-program registry — the seam that makes `loadEffect()` real.
+ *
+ * A `.dope` is renderer-agnostic data, but it references a SHADER PROGRAM by key
+ * (`render.backends.webgl2.shader.program`, e.g. "solarbloom"). The runtime ships
+ * a small set of bundled programs; each is a `create(params, ctx)` renderer (the
+ * GLSL body + uniform plumbing) plus the metadata the loader needs to resolve the
+ * `.dope` into that renderer's params: the per-fire scatter key (moteSeed /
+ * inkSeed / …), the integer-clamp consts (MAX_MOTES / MAX_DROPS), whether it
+ * casts a shadow, and its reduced-motion peak.
+ *
+ * Built-in effects register their renderer here (in addition to registering
+ * themselves as an `EffectFactory`), so `loadEffect(anyDopeDoc)` can bind an
+ * arbitrary, host-authored `.dope` to a bundled program with NO new code — the
+ * whole point of the format. This is "the format references shader bodies; it is
+ * not a transpiler" made concrete: the doc carries data + a program key; the
+ * runtime owns the GLSL the key resolves to.
+ */
+const programs = new Map();
+/** Register (or override) a bundled render program by key. */
+export function registerProgram(name, program) {
+    programs.set(name, program);
+    return program;
+}
+/** Look up a bundled render program by key. */
+export function getProgram(name) {
+    return programs.get(name);
+}
+/** Names of all registered render programs. */
+export function programNames() {
+    return [...programs.keys()];
+}
+//# sourceMappingURL=programs.js.map

package/dist/framework/programs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.js","sourceRoot":"","sources":["../../src/framework/programs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA4BH,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,8DAA8D;AAC9D,MAAM,UAAU,eAAe,CAAI,IAAY,EAAE,OAAyB;IACxE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAwB,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/framework/registry.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Effect registry — the lookup table the runtime uses to find an effect by name.
+ *
+ * Effects self-register on import (see `effects/*.ts`), which keeps the registry
+ * tree-shakeable: if you never import an effect, it never lands in the bundle
+ * *or* the registry. The public `play({ effect })` / element / React surfaces
+ * all route through here.
+ */
+import type { EffectFactory } from "./effect.js";
+/**
+ * Register (or override) an effect. Returns the factory so registration can be
+ * the module's export pattern:
+ *
+ * ```ts
+ * export default registerEffect({
+ *   name: "confetti",
+ *   resolve(feeling, mood) { ... },
+ *   create(params, ctx) { ... },
+ * });
+ * ```
+ */
+export declare function registerEffect<P>(factory: EffectFactory<P>): EffectFactory<P>;
+/** Look up an effect by name, or `undefined` if it hasn't been registered. */
+export declare function getEffect(name: string): EffectFactory | undefined;
+/** Whether an effect name is registered. */
+export declare function hasEffect(name: string): boolean;
+/** Names of all registered effects. */
+export declare function effectNames(): string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/framework/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/framework/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAG7E;AAED,8EAA8E;AAC9E,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEjE;AAED,4CAA4C;AAC5C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,uCAAuC;AACvC,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC"}

package/dist/framework/registry.js

@@ -0,0 +1,38 @@
+/**
+ * Effect registry — the lookup table the runtime uses to find an effect by name.
+ *
+ * Effects self-register on import (see `effects/*.ts`), which keeps the registry
+ * tree-shakeable: if you never import an effect, it never lands in the bundle
+ * *or* the registry. The public `play({ effect })` / element / React surfaces
+ * all route through here.
+ */
+const effects = new Map();
+/**
+ * Register (or override) an effect. Returns the factory so registration can be
+ * the module's export pattern:
+ *
+ * ```ts
+ * export default registerEffect({
+ *   name: "confetti",
+ *   resolve(feeling, mood) { ... },
+ *   create(params, ctx) { ... },
+ * });
+ * ```
+ */
+export function registerEffect(factory) {
+    effects.set(factory.name, factory);
+    return factory;
+}
+/** Look up an effect by name, or `undefined` if it hasn't been registered. */
+export function getEffect(name) {
+    return effects.get(name);
+}
+/** Whether an effect name is registered. */
+export function hasEffect(name) {
+    return effects.has(name);
+}
+/** Names of all registered effects. */
+export function effectNames() {
+    return [...effects.keys()];
+}
+//# sourceMappingURL=registry.js.map

package/dist/framework/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/framework/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEjD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAI,OAAyB;IACzD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAwB,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,WAAW;IACzB,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AAC7B,CAAC"}

package/dist/framework/runtime.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Runtime-environment guards. Every access to a browser-only global
+ * (`document`, `window`, `matchMedia`, `devicePixelRatio`) goes through here so
+ * the whole library is SSR-safe: importing `@dopaminefx/core` on a server, or
+ * calling `celebrate()` where there is no DOM, is a no-op rather than a crash.
+ */
+/** True only in a real browser with a DOM we can mount an overlay into. */
+export declare function isBrowser(): boolean;
+/** Whether the document is currently hidden (background tab). SSR-safe. */
+export declare function isDocumentHidden(): boolean;
+/**
+ * Whether the user has asked for reduced motion. SSR-safe and defensive: if
+ * `matchMedia` is unavailable or throws we assume motion is fine (the prior
+ * default behaviour).
+ */
+export declare function prefersReducedMotion(): boolean;
+/** Device-pixel ratio, capped at 2 to bound fill cost under software WebGL. */
+export declare function deviceDpr(): number;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/framework/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/framework/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2EAA2E;AAC3E,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAS9C;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,IAAI,MAAM,CAGlC"}

package/dist/framework/runtime.js

@@ -0,0 +1,37 @@
+/**
+ * Runtime-environment guards. Every access to a browser-only global
+ * (`document`, `window`, `matchMedia`, `devicePixelRatio`) goes through here so
+ * the whole library is SSR-safe: importing `@dopaminefx/core` on a server, or
+ * calling `celebrate()` where there is no DOM, is a no-op rather than a crash.
+ */
+/** True only in a real browser with a DOM we can mount an overlay into. */
+export function isBrowser() {
+    return typeof document !== "undefined" && typeof window !== "undefined";
+}
+/** Whether the document is currently hidden (background tab). SSR-safe. */
+export function isDocumentHidden() {
+    return typeof document !== "undefined" && document.visibilityState === "hidden";
+}
+/**
+ * Whether the user has asked for reduced motion. SSR-safe and defensive: if
+ * `matchMedia` is unavailable or throws we assume motion is fine (the prior
+ * default behaviour).
+ */
+export function prefersReducedMotion() {
+    if (typeof window === "undefined" || typeof window.matchMedia !== "function") {
+        return false;
+    }
+    try {
+        return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    }
+    catch {
+        return false;
+    }
+}
+/** Device-pixel ratio, capped at 2 to bound fill cost under software WebGL. */
+export function deviceDpr() {
+    if (typeof window === "undefined")
+        return 1;
+    return Math.min(window.devicePixelRatio || 1, 2);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/framework/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/framework/runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,2EAA2E;AAC3E,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,QAAQ,KAAK,WAAW,IAAI,OAAO,MAAM,KAAK,WAAW,CAAC;AAC1E,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,CAAC;AAClF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC7E,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,SAAS;IACvB,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @dopaminefx/core — the EFFECT-FREE runtime + public API.
+ *
+ * This is the slim runtime: the conductor (overlay + shared program-cached GL
+ * contexts + RAF loop), the registry, the mood registry, the `.dope` loader +
+ * `loadEffect`, the generic runners (pass + panel), the shared engine bits
+ * (color, sdf, shadow, seed, context, gl, the `look/` GLSL chunks, tempo
+ * PRIMITIVES) and the generic `play(name, …)` / `prepare(name, …)` API.
+ *
+ * Core imports + registers NO effect. Each effect ships as its own
+ * `@dopaminefx/effect-<name>` package that depends on this and self-registers on
+ * import; the `@dopaminefx/effects` umbrella bundles all nine + the `celebrate*`
+ * conveniences + the `<dopamine-success>` element.
+ */
+import { type PlayHandle } from "./framework/conductor.js";
+import type { DopamineSuccessOptions } from "./types.js";
+export type { DopamineMood, DopamineSuccessOptions } from "./types.js";
+export type { RGB, OKLCH } from "./engine/color.js";
+export { buildPalette, oklchToLinearSrgb, wrapHue, GOLDEN_ANGLE_DEG, type PaletteParams } from "./engine/color.js";
+export { mulberry32, randomSeed, type Rng } from "./engine/seed.js";
+export type { Effect, EffectFactory, EffectInstance, EffectContext, FeelingInput, Anchor, } from "./framework/effect.js";
+export { registerEffect, getEffect, hasEffect, effectNames } from "./framework/registry.js";
+export { registerMood, resolveMood, hasMood, moodNames, type MoodSpec, type ResolvedMood, } from "./framework/mood-registry.js";
+export { teardown, type PreparedHandle, type PlayHandle } from "./framework/conductor.js";
+export { loadEffect, loadEffectSync, type LoadEffectOptions, type LoadOverrides, type LoadedEffect, } from "./framework/load-effect.js";
+export { registerProgram, getProgram, programNames, type RenderProgram } from "./framework/programs.js";
+export { parseDope, resolveDopeParams, getOutline, type DopeDoc, type DopeOutline, type DopeBinding, type DopeSampler, type DopeFrameSpec, type DopeLoopSpec, } from "./framework/loader.js";
+export { dopePassConfig, dopePanelConfig, registerDopeEffect, registerDopePanelEffect, type DopePassHooks, type DopeShader, type RegisterDopeEffectOptions, } from "./framework/dope-pass.js";
+export { evalFrameExpr, evalParamExpr, evalPassExpr, type FrameExprNode, type FrameExprCtx, type PassExprInputs, } from "./framework/frame-expr.js";
+export { pickFromList, pickBand, resolveTypography, type DopeTypography, } from "./framework/content.js";
+export { bakeSdf, decodeSdf, parseSvgPath, type BakedSdf, type DecodedSdf } from "./engine/sdf.js";
+export { createPassInstance, type PassConfig, type PassParams, type AuxTextureSpec, type FrameInfo, } from "./framework/pass-runner.js";
+export { createPanelInstance, type PanelConfig, type PanelDraw, type PanelFrameInfo, } from "./framework/panel-runner.js";
+export { clamp01, easeOutCubic, easeOutBack, envelope, NPR_TIME_STEP_MS, } from "./engine/tempo.js";
+export * from "./engine/look/glsl.js";
+export { GLSL_PARTICLES } from "./engine/look/particles.glsl.js";
+/**
+ * Generic real-time fire: play a registered effect by name. Resolves when the
+ * animation has fully played out. A CONTINUOUS effect (one whose `.dope`
+ * declares `tempo.loop`, e.g. halo) loops seamlessly until the host calls the
+ * returned handle's `stop()`. The handle's `pause()`/`resume()` freeze and
+ * resume the timeline drift-free (parking a perpetual loop so it costs no
+ * battery; the conductor also auto-pauses on a hidden tab). SSR-safe (resolves
+ * immediately off-DOM). The effect must already be registered (import
+ * `@dopaminefx/effect-<name>` or the `@dopaminefx/effects` umbrella, or load one
+ * via `loadEffect`).
+ */
+export declare function play(effect: string, options?: DopamineSuccessOptions): PlayHandle;
+/** A prepared, manually-driven effect handle (offline capture / external clock). */
+export interface PreparedEffect {
+    readonly durationMs: number;
+    /** Draw the frame at `elapsedMs` since the start. */
+    renderAt(elapsedMs: number): void;
+    /** Dispose the renderer *and* release the overlay. */
+    dispose(): void;
+}
+/**
+ * Generic prepared effect: mount the overlay and return a renderer you drive
+ * yourself via `renderAt(elapsedMs)`. Call `dispose()` when finished. Returns
+ * `null` in non-DOM environments.
+ */
+export declare function prepare(effect: string, options?: DopamineSuccessOptions): PreparedEffect | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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