@dopaminefx/core 0.1.0

package/dist/framework/dope-zip.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Minimal `.dope` zip (dotLottie-style) reader.
+ *
+ * A distributed `.dope` may be a zip: a `manifest.json` naming the effect doc
+ * plus an `assets/` dir referenced by RELATIVE paths only. This reads the zip
+ * entries (STORED or DEFLATE), finds the effect JSON via the manifest (or the
+ * first `*.json` under `effects/`), and resolves any relative asset `$ref`s in
+ * `geometry.outlines.*` by inlining them as `data:` URIs — so the doc handed to
+ * the loader is fully self-contained. Remote/absolute refs are rejected (the
+ * loader's standalone guard would reject them anyway; we fail early + clearly).
+ *
+ * Dependency-free: STORED entries are read directly; DEFLATE entries use the
+ * platform `DecompressionStream` when present (browsers + Node ≥18). We don't
+ * bundle a zlib.
+ */
+/**
+ * Read a `.dope` zip → the fully-inlined effect document (a parsed object).
+ * Resolves the effect JSON via manifest.json, then inlines relative `$ref`/asset
+ * paths under geometry/outlines from the zip's `assets/`.
+ */
+export declare function readDopeZip(buf: Uint8Array): Promise<object>;
+//# sourceMappingURL=dope-zip.d.ts.map

package/dist/framework/dope-zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dope-zip.d.ts","sourceRoot":"","sources":["../../src/framework/dope-zip.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA2DH;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA8ClE"}

package/dist/framework/dope-zip.js

@@ -0,0 +1,116 @@
+/**
+ * Minimal `.dope` zip (dotLottie-style) reader.
+ *
+ * A distributed `.dope` may be a zip: a `manifest.json` naming the effect doc
+ * plus an `assets/` dir referenced by RELATIVE paths only. This reads the zip
+ * entries (STORED or DEFLATE), finds the effect JSON via the manifest (or the
+ * first `*.json` under `effects/`), and resolves any relative asset `$ref`s in
+ * `geometry.outlines.*` by inlining them as `data:` URIs — so the doc handed to
+ * the loader is fully self-contained. Remote/absolute refs are rejected (the
+ * loader's standalone guard would reject them anyway; we fail early + clearly).
+ *
+ * Dependency-free: STORED entries are read directly; DEFLATE entries use the
+ * platform `DecompressionStream` when present (browsers + Node ≥18). We don't
+ * bundle a zlib.
+ */
+function u16(b, o) {
+    return b[o] | (b[o + 1] << 8);
+}
+function u32(b, o) {
+    return (b[o] | (b[o + 1] << 8) | (b[o + 2] << 16) | (b[o + 3] << 24)) >>> 0;
+}
+/** Parse the local-file-header records of a zip into raw entries. */
+function parseZip(buf) {
+    const entries = [];
+    const dec = new TextDecoder();
+    let i = 0;
+    while (i + 4 <= buf.length) {
+        const sig = u32(buf, i);
+        if (sig !== 0x04034b50)
+            break; // local file header; central dir / EOCD follow
+        const method = u16(buf, i + 8);
+        const compSize = u32(buf, i + 18);
+        const nameLen = u16(buf, i + 26);
+        const extraLen = u16(buf, i + 28);
+        const nameStart = i + 30;
+        const name = dec.decode(buf.subarray(nameStart, nameStart + nameLen));
+        const dataStart = nameStart + nameLen + extraLen;
+        const data = buf.subarray(dataStart, dataStart + compSize);
+        entries.push({ name, method, data });
+        i = dataStart + compSize;
+    }
+    if (entries.length === 0)
+        throw new Error("dope: not a zip (no local file headers)");
+    return entries;
+}
+async function inflate(entry) {
+    if (entry.method === 0)
+        return entry.data.slice(); // STORED
+    if (entry.method === 8) {
+        // raw DEFLATE
+        if (typeof globalThis.DecompressionStream === "undefined") {
+            throw new Error("dope: DEFLATE zip entry but no DecompressionStream available");
+        }
+        const DS = globalThis
+            .DecompressionStream;
+        const ds = new DS("deflate-raw");
+        // Copy into a standalone ArrayBuffer-backed view for the Blob part.
+        const part = new Uint8Array(entry.data.length);
+        part.set(entry.data);
+        const stream = new Response(new Blob([part]).stream().pipeThrough(ds));
+        return new Uint8Array(await stream.arrayBuffer());
+    }
+    throw new Error(`dope: unsupported zip compression method ${entry.method}`);
+}
+const ABS_OR_REMOTE = /^(?:[a-z][a-z0-9+.-]*:)?\/\/|^\//i;
+/**
+ * Read a `.dope` zip → the fully-inlined effect document (a parsed object).
+ * Resolves the effect JSON via manifest.json, then inlines relative `$ref`/asset
+ * paths under geometry/outlines from the zip's `assets/`.
+ */
+export async function readDopeZip(buf) {
+    const entries = parseZip(buf);
+    const files = new Map();
+    for (const e of entries)
+        files.set(e.name.replace(/^\.?\//, ""), e);
+    const textOf = async (name) => {
+        const e = files.get(name);
+        if (!e)
+            throw new Error(`dope zip: missing entry "${name}"`);
+        return new TextDecoder().decode(await inflate(e));
+    };
+    // Locate the effect doc.
+    let effectPath;
+    if (files.has("manifest.json")) {
+        const manifest = JSON.parse(await textOf("manifest.json"));
+        effectPath = manifest.effects?.[0]?.path?.replace(/^\.?\//, "");
+    }
+    if (!effectPath) {
+        effectPath = [...files.keys()].find((n) => /^effects\/.+\.json$/.test(n)) ?? "effect.json";
+    }
+    const doc = JSON.parse(await textOf(effectPath));
+    // Inline relative asset refs in geometry.outlines.*.sdf when stored as a path.
+    const geo = doc.geometry;
+    if (geo?.outlines) {
+        for (const outline of Object.values(geo.outlines)) {
+            const sdf = outline.sdf;
+            const ref = (sdf?.data ?? outline.sdfRef);
+            if (typeof ref === "string" && !ref.startsWith("data:")) {
+                if (ABS_OR_REMOTE.test(ref)) {
+                    throw new Error(`dope zip: outline asset must be a relative path, got "${ref}"`);
+                }
+                const e = files.get(ref.replace(/^\.?\//, ""));
+                if (!e)
+                    throw new Error(`dope zip: missing asset "${ref}"`);
+                const bytes = await inflate(e);
+                const b64 = typeof Buffer !== "undefined"
+                    ? Buffer.from(bytes).toString("base64")
+                    : btoa(String.fromCharCode(...bytes));
+                if (sdf)
+                    sdf.data = `data:application/octet-stream;base64,${b64}`;
+            }
+        }
+    }
+    return doc;
+}
+//# sourceMappingURL=dope-zip.js.map

package/dist/framework/dope-zip.js.map

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

package/dist/framework/effect.d.ts

@@ -0,0 +1,128 @@
+/**
+ * The Dopamine effect framework — the backbone every visual effect plugs into.
+ *
+ * An *effect* (Solarbloom, Calligraphic Verdict, Comic Impact, and future
+ * progress / error / attention effects) is a self-contained module that knows
+ * two things:
+ *
+ *  1. how to turn the human-facing "feeling" knobs (mood / intensity / whimsy)
+ *     plus a seed into its own concrete, deterministic render parameters, and
+ *  2. how to draw a single frame at an arbitrary `elapsedMs` into a shared GPU
+ *     surface — both the light pass and (if present) the multiply shadow pass.
+ *
+ * Effects never create the DOM overlay, the GL context, or the RAF loop — the
+ * runtime (the conductor) owns all of that. That separation is what lets a new
+ * effect be a small file that self-registers, and keeps the library
+ * tree-shakeable: importing one effect pulls in nothing from the others.
+ */
+import type { GLContext } from "../engine/context.js";
+import type { ResolvedMood } from "./mood-registry.js";
+/** Origin/anchor in CSS pixels, relative to the render surface's top-left. */
+export interface Anchor {
+    x: number;
+    y: number;
+}
+/**
+ * The "feeling" API, shared by every effect. Individual effects map these onto
+ * their own low-level parameters via {@link EffectFactory.resolve}. This is the
+ * deliberate seam between *what a developer expresses* (a feeling) and *what the
+ * shader consumes* (numbers).
+ */
+export interface FeelingInput {
+    /** Emotional register — a registered mood name. */
+    mood: string;
+    /** 0..1 — arousal/valence: saturation, brightness, scale, overshoot. */
+    intensity: number;
+    /** 0..1 — stylization: photoreal (0) ↔ cel / hand-drawn "animate on twos" (1). */
+    whimsy: number;
+    /** Deterministic seed for the algorithmic color + motion. */
+    seed: number;
+}
+/**
+ * Everything an effect instance needs to draw, supplied by the runtime. The
+ * effect draws its light pass into `light` and, when `shadow` is non-null, its
+ * occlusion silhouette into `shadow` (a separate `mix-blend-mode: multiply`
+ * canvas + context). Both contexts are persistent + program-cached.
+ */
+export interface EffectContext {
+    /** Shared WebGL2 light context (`screen` blend) + program cache. */
+    readonly light: GLContext;
+    /** Shared WebGL2 shadow context (`multiply` blend), or null if disabled. */
+    readonly shadow: GLContext | null;
+    /** Where the effect is anchored, in CSS px relative to the surface. */
+    readonly anchor: Anchor;
+    /**
+     * Size (CSS px) of the underlying element the effect targets, centred on
+     * {@link anchor}. The centrepiece (checkmark, ✗, comic word, hero heart, ink
+     * gesture) is sized to THIS box so it matches the page element. Omitted ⇒ the
+     * full render surface (the centrepiece fills the canvas, as before).
+     */
+    readonly targetSize?: {
+        width: number;
+        height: number;
+    };
+    /** Device-pixel ratio to render at (already capped by the runtime). */
+    readonly dpr: number;
+    /**
+     * Present when the host composites against a known backdrop colour rather than
+     * the default `mix-blend-mode: screen`. The runners then emit PREMULTIPLIED
+     * light (alpha = brightness) on the light pass so the effect stays visible on
+     * any surface — white included — composited source-over. Absent ⇒ the classic
+     * screen/opaque path (byte-identical to before).
+     */
+    readonly composite?: {
+        premultiplied: boolean;
+    };
+}
+/** A live, drawable effect. Pure function of time: same `elapsedMs` → same frame. */
+export interface EffectInstance {
+    /** Total length in ms after which the effect has fully played out. */
+    readonly durationMs: number;
+    /** Draw the frame at `elapsedMs` since the effect started. */
+    renderAt(elapsedMs: number): void;
+    /** Release any per-instance GPU resources (not shared/cached ones). */
+    dispose(): void;
+}
+/**
+ * The contract a new effect implements. `Params` is the effect's private,
+ * fully-resolved parameter shape — opaque to the runtime.
+ */
+export interface EffectFactory<Params = unknown> {
+    /** Stable, unique id, e.g. `"solarbloom"`. Used by the registry + API. */
+    readonly name: string;
+    /**
+     * Map the shared feeling knobs + a resolved mood into this effect's own
+     * deterministic params. Pure — no DOM, no GL, no randomness beyond the seed.
+     */
+    resolve(feeling: FeelingInput, mood: ResolvedMood): Params;
+    /** Build a drawable instance for the given resolved params + context. */
+    create(params: Params, ctx: EffectContext): EffectInstance;
+    /**
+     * Whether this effect wants a shadow (multiply) companion canvas. Defaults to
+     * true; an effect that casts no shadow can opt out to skip the second context.
+     */
+    readonly castsShadow?: boolean;
+    /**
+     * Optional reduced-motion handling: which `elapsedMs` of the timeline best
+     * represents a calm peak, and how long to hold that single static frame
+     * instead of animating. Sensible defaults are used if omitted.
+     */
+    readonly reducedMotion?: {
+        /** How long to hold the minimal frame, ms. Default 360. */
+        holdMs?: number;
+        /** Which `elapsedMs` of the full timeline best represents a calm peak. */
+        peakMs?: number;
+    };
+    /**
+     * CONTINUOUS-loop contract (from `tempo.loop`): the effect repeats seamlessly
+     * with this period and `durationMs` is a whole number of periods. The
+     * conductor re-arms it at `durationMs` instead of tearing down — the host
+     * stops it via the handle `play()` returns. Absent for one-shot effects.
+     */
+    readonly loop?: {
+        periodMs: number;
+    };
+}
+/** Public alias: an `Effect` is what you register and play by name. */
+export type Effect<Params = unknown> = EffectFactory<Params>;
+//# sourceMappingURL=effect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"effect.d.ts","sourceRoot":"","sources":["../../src/framework/effect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,8EAA8E;AAC9E,MAAM,WAAW,MAAM;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,CAAC;CACjD;AAED,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,MAAM,GAAG,OAAO;IAC7C,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,YAAY,GAAG,MAAM,CAAC;IAC3D,yEAAyE;IACzE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,cAAc,CAAC;IAC3D;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE;QACvB,2DAA2D;QAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,0EAA0E;QAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,uEAAuE;AACvE,MAAM,MAAM,MAAM,CAAC,MAAM,GAAG,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC"}

package/dist/framework/effect.js

@@ -0,0 +1,19 @@
+/**
+ * The Dopamine effect framework — the backbone every visual effect plugs into.
+ *
+ * An *effect* (Solarbloom, Calligraphic Verdict, Comic Impact, and future
+ * progress / error / attention effects) is a self-contained module that knows
+ * two things:
+ *
+ *  1. how to turn the human-facing "feeling" knobs (mood / intensity / whimsy)
+ *     plus a seed into its own concrete, deterministic render parameters, and
+ *  2. how to draw a single frame at an arbitrary `elapsedMs` into a shared GPU
+ *     surface — both the light pass and (if present) the multiply shadow pass.
+ *
+ * Effects never create the DOM overlay, the GL context, or the RAF loop — the
+ * runtime (the conductor) owns all of that. That separation is what lets a new
+ * effect be a small file that self-registers, and keeps the library
+ * tree-shakeable: importing one effect pulls in nothing from the others.
+ */
+export {};
+//# sourceMappingURL=effect.js.map

package/dist/framework/effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.js","sourceRoot":"","sources":["../../src/framework/effect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/framework/frame-expr.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Per-FRAME expression evaluator — the datafied form of an effect's `frame()` /
+ * `shadowHeightFrac` logic hooks.
+ *
+ * The resolve-time grammar (`loader.ts` `evalExpr`) maps a feeling into the
+ * resolved param bag ONCE per fire. This module is its per-frame sibling: it
+ * evaluates the `.dope` `tempo.frame` / `render.shadowHeightFrac` expression
+ * trees EVERY frame against the live clocks (`animMs` / `life` / `elapsedMs`,
+ * plus the `loopS` / `phase` loop clocks for effects with `tempo.loop`) and
+ * the resolved params — so the per-frame logic, like the resolve mapping,
+ * is authored once in the `.dope` and interpreted identically on every
+ * platform. The same grammar also powers the PER-PASS `render.pass`
+ * expressions ({@link evalPassExpr}): params plus the pass-geometry inputs
+ * (`targetMinDimPx` / `sdfRange` / `sdfViewBoxW`), with the frame clocks
+ * rejected — pass values are computed once per pass, not per frame.
+ *
+ * Like `evalExpr`, nodes are evaluated RAW (no decode step) and anything
+ * outside the grammar THROWS. The tempo primitives (`envelope`, `easeOutBack`,
+ * `easeOutCubic`, `clamp01`) are the SAME functions the hand-written hooks
+ * called (imported from `engine/tempo.ts`), so a datafied effect's output is
+ * bit-identical to the code it replaced.
+ */
+/** The per-frame expression grammar — an expression tree over the frame ctx. */
+export type FrameExprNode = number | {
+    const: number;
+} | {
+    param: string;
+} | {
+    input: "animMs" | "life" | "elapsedMs" | "loopS" | "phase" | "targetMinDimPx" | "sdfRange" | "sdfViewBoxW" | "dpr";
+} | {
+    add: FrameExprNode[];
+} | {
+    sub: FrameExprNode[];
+} | {
+    mul: FrameExprNode[];
+} | {
+    div: FrameExprNode[];
+} | {
+    min: FrameExprNode[];
+} | {
+    max: FrameExprNode[];
+} | {
+    pow: [FrameExprNode, FrameExprNode];
+} | {
+    sin: FrameExprNode;
+} | {
+    cos: FrameExprNode;
+} | {
+    exp: FrameExprNode;
+} | {
+    clamp01: FrameExprNode;
+} | {
+    lt: [FrameExprNode, FrameExprNode, FrameExprNode, FrameExprNode];
+} | {
+    envelope: [FrameExprNode, FrameExprNode];
+} | {
+    easeOutCubic: FrameExprNode;
+} | {
+    easeOutBack: [FrameExprNode, FrameExprNode];
+};
+/** Evaluation context for a per-frame expression. */
+export interface FrameExprCtx {
+    /** The "on twos"-snapped animation clock in ms (stepping already applied). */
+    animMs: number;
+    /** Normalized life 0..1 (animMs / durationMs, clamped). */
+    life: number;
+    /** The REAL un-stepped wall clock in ms (mirrors the Swift/Android runners). */
+    elapsedMs: number;
+    /** The resolved render-param bag (numeric entries are addressable). */
+    params: Record<string, unknown>;
+    /**
+     * Seconds within the current loop (`(animMs % tempo.loop.periodMs) / 1000`).
+     * 0 for an effect with no `tempo.loop` — the caller (the dope-pass frame
+     * derivation) fills these from the doc's loop contract.
+     */
+    loopS?: number;
+    /** Normalized loop phase in [0, 1) (`animMs % periodMs / periodMs`); 0 without a loop. */
+    phase?: number;
+    /** Pass-geometry inputs (see {@link PassExprInputs}); only read in "pass" mode. */
+    pass?: PassExprInputs;
+}
+/**
+ * The pass-geometry inputs a `render.pass` expression may read (evaluated ONCE
+ * per pass by the runners, never per resolve or per frame).
+ */
+export interface PassExprInputs {
+    /**
+     * Min dimension of the TARGETED element box in device px, falling back to
+     * the full canvas when untargeted — the same target-fallback the standard
+     * `uTarget` uniform uses, so a pass-sized centrepiece tracks the element.
+     */
+    targetMinDimPx: number;
+    /**
+     * The declared `range` of the SDF behind the first `binding.samplers` entry
+     * with an `outline` source (author units → the full byte range); 0 when no
+     * sampler declares one.
+     */
+    sdfRange: number;
+    /** That SDF's `viewBox[2]` (author-units width); 0 when absent. */
+    sdfViewBoxW: number;
+    /**
+     * The device-pixel ratio (web `devicePixelRatio` / Android `density` / the
+     * Metal layer's content scale) the surface renders at — so a pass value can
+     * be expressed in CSS-ish units and scaled to device px (e.g. heartburst's
+     * halftone cell `uDotSize = dotSize · dpr`).
+     */
+    dpr: number;
+}
+/** Evaluate a per-frame grammar node to a number. Pure; throws outside the grammar. */
+export declare function evalFrameExpr(node: FrameExprNode, ctx: FrameExprCtx): number;
+/**
+ * Evaluate a PARAMS-ONLY expression (e.g. `render.shadowHeightFrac`): the same
+ * grammar, but `{input}` nodes THROW — a shadow-geometry expression must be a
+ * pure function of the resolved params, never of the frame clock.
+ */
+export declare function evalParamExpr(node: FrameExprNode, params: Record<string, unknown>): number;
+/**
+ * Evaluate a PER-PASS expression (`render.pass`): the same grammar over the
+ * resolved params plus the pass-geometry inputs (`targetMinDimPx` / `sdfRange`
+ * / `sdfViewBoxW`). Frame clocks (`animMs` / `life` / …) THROW — a pass
+ * expression is evaluated once per pass, not per frame.
+ */
+export declare function evalPassExpr(node: FrameExprNode, params: Record<string, unknown>, pass: PassExprInputs): number;
+//# sourceMappingURL=frame-expr.d.ts.map

package/dist/framework/frame-expr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-expr.d.ts","sourceRoot":"","sources":["../../src/framework/frame-expr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,gFAAgF;AAChF,MAAM,MAAM,aAAa,GACrB,MAAM,GACN;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IACE,KAAK,EACD,QAAQ,GACR,MAAM,GACN,WAAW,GACX,OAAO,GACP,OAAO,GAGP,gBAAgB,GAChB,UAAU,GACV,aAAa,GACb,KAAK,CAAC;CACX,GACD;IAAE,GAAG,EAAE,aAAa,EAAE,CAAA;CAAE,GACxB;IAAE,GAAG,EAAE,aAAa,EAAE,CAAA;CAAE,GACxB;IAAE,GAAG,EAAE,aAAa,EAAE,CAAA;CAAE,GACxB;IAAE,GAAG,EAAE,aAAa,EAAE,CAAA;CAAE,GACxB;IAAE,GAAG,EAAE,aAAa,EAAE,CAAA;CAAE,GACxB;IAAE,GAAG,EAAE,aAAa,EAAE,CAAA;CAAE,GACxB;IAAE,GAAG,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;CAAE,GACvC;IAAE,GAAG,EAAE,aAAa,CAAA;CAAE,GACtB;IAAE,GAAG,EAAE,aAAa,CAAA;CAAE,GACtB;IAAE,GAAG,EAAE,aAAa,CAAA;CAAE,GACtB;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,GAC1B;IAAE,EAAE,EAAE,CAAC,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,CAAC,CAAA;CAAE,GACpE;IAAE,QAAQ,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;CAAE,GAC5C;IAAE,YAAY,EAAE,aAAa,CAAA;CAAE,GAC/B;IAAE,WAAW,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,CAAA;CAAE,CAAC;AAEpD,qDAAqD;AACrD,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;OAIG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,GAAG,EAAE,MAAM,CAAC;CACb;AAkFD,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,cAAc,GACnB,MAAM,CAER"}

package/dist/framework/frame-expr.js

@@ -0,0 +1,135 @@
+/**
+ * Per-FRAME expression evaluator — the datafied form of an effect's `frame()` /
+ * `shadowHeightFrac` logic hooks.
+ *
+ * The resolve-time grammar (`loader.ts` `evalExpr`) maps a feeling into the
+ * resolved param bag ONCE per fire. This module is its per-frame sibling: it
+ * evaluates the `.dope` `tempo.frame` / `render.shadowHeightFrac` expression
+ * trees EVERY frame against the live clocks (`animMs` / `life` / `elapsedMs`,
+ * plus the `loopS` / `phase` loop clocks for effects with `tempo.loop`) and
+ * the resolved params — so the per-frame logic, like the resolve mapping,
+ * is authored once in the `.dope` and interpreted identically on every
+ * platform. The same grammar also powers the PER-PASS `render.pass`
+ * expressions ({@link evalPassExpr}): params plus the pass-geometry inputs
+ * (`targetMinDimPx` / `sdfRange` / `sdfViewBoxW`), with the frame clocks
+ * rejected — pass values are computed once per pass, not per frame.
+ *
+ * Like `evalExpr`, nodes are evaluated RAW (no decode step) and anything
+ * outside the grammar THROWS. The tempo primitives (`envelope`, `easeOutBack`,
+ * `easeOutCubic`, `clamp01`) are the SAME functions the hand-written hooks
+ * called (imported from `engine/tempo.ts`), so a datafied effect's output is
+ * bit-identical to the code it replaced.
+ */
+import { clamp01, easeOutBack, easeOutCubic, envelope } from "../engine/tempo.js";
+const FRAME_INPUTS = ["animMs", "life", "elapsedMs", "loopS", "phase"];
+const PASS_INPUTS = ["targetMinDimPx", "sdfRange", "sdfViewBoxW", "dpr"];
+function evalInput(name, ctx, mode) {
+    const isFrame = FRAME_INPUTS.includes(name);
+    const isPass = PASS_INPUTS.includes(name);
+    if (mode === "pass") {
+        if (isFrame) {
+            throw new Error(`dope: frame input "${name}" is not allowed in a render.pass expression (pass expressions are not frame-clocked)`);
+        }
+        if (isPass)
+            return ctx.pass?.[name] ?? 0;
+        throw new Error(`dope: unknown frame input "${name}"`);
+    }
+    if (isPass) {
+        throw new Error(`dope: pass input "${name}" is only allowed in a render.pass expression`);
+    }
+    if (mode === "params") {
+        throw new Error(`dope: {input} is not allowed in a params-only expression (got "${name}")`);
+    }
+    if (name === "animMs")
+        return ctx.animMs;
+    if (name === "life")
+        return ctx.life;
+    if (name === "elapsedMs")
+        return ctx.elapsedMs;
+    if (name === "loopS")
+        return ctx.loopS ?? 0;
+    if (name === "phase")
+        return ctx.phase ?? 0;
+    throw new Error(`dope: unknown frame input "${name}"`);
+}
+function evalNode(node, ctx, mode) {
+    if (typeof node === "number")
+        return node;
+    if ("const" in node)
+        return node.const;
+    if ("param" in node) {
+        const raw = ctx.params[node.param];
+        if (typeof raw !== "number") {
+            throw new Error(`dope: frame expr references missing/non-numeric param "${node.param}"`);
+        }
+        return Number(raw);
+    }
+    if ("input" in node)
+        return evalInput(String(node.input), ctx, mode);
+    if ("add" in node)
+        return node.add.reduce((p, n) => p + evalNode(n, ctx, mode), 0);
+    if ("sub" in node) {
+        const parts = node.sub.map((n) => evalNode(n, ctx, mode));
+        return parts.slice(1).reduce((p, n) => p - n, parts[0] ?? 0);
+    }
+    if ("mul" in node)
+        return node.mul.reduce((p, n) => p * evalNode(n, ctx, mode), 1);
+    if ("div" in node) {
+        const parts = node.div.map((n) => evalNode(n, ctx, mode));
+        return parts.slice(1).reduce((p, n) => p / n, parts[0] ?? 0);
+    }
+    if ("min" in node)
+        return Math.min(...node.min.map((n) => evalNode(n, ctx, mode)));
+    if ("max" in node)
+        return Math.max(...node.max.map((n) => evalNode(n, ctx, mode)));
+    if ("pow" in node) {
+        return Math.pow(evalNode(node.pow[0], ctx, mode), evalNode(node.pow[1], ctx, mode));
+    }
+    if ("sin" in node)
+        return Math.sin(evalNode(node.sin, ctx, mode));
+    if ("cos" in node)
+        return Math.cos(evalNode(node.cos, ctx, mode));
+    if ("exp" in node)
+        return Math.exp(evalNode(node.exp, ctx, mode));
+    if ("clamp01" in node)
+        return clamp01(evalNode(node.clamp01, ctx, mode));
+    if ("lt" in node) {
+        // Branches are evaluated LAZILY (only the taken branch), so a guard like
+        // `0 < elapsedMs ? f(elapsedMs) : 0` never evaluates f outside its domain.
+        const [a, b, then, otherwise] = node.lt;
+        return evalNode(a, ctx, mode) < evalNode(b, ctx, mode)
+            ? evalNode(then, ctx, mode)
+            : evalNode(otherwise, ctx, mode);
+    }
+    if ("envelope" in node) {
+        return envelope(evalNode(node.envelope[0], ctx, mode), evalNode(node.envelope[1], ctx, mode));
+    }
+    if ("easeOutCubic" in node)
+        return easeOutCubic(evalNode(node.easeOutCubic, ctx, mode));
+    if ("easeOutBack" in node) {
+        return easeOutBack(evalNode(node.easeOutBack[0], ctx, mode), evalNode(node.easeOutBack[1], ctx, mode));
+    }
+    throw new Error(`dope: unknown frame expr node ${JSON.stringify(node)}`);
+}
+/** Evaluate a per-frame grammar node to a number. Pure; throws outside the grammar. */
+export function evalFrameExpr(node, ctx) {
+    return evalNode(node, ctx, "frame");
+}
+/**
+ * Evaluate a PARAMS-ONLY expression (e.g. `render.shadowHeightFrac`): the same
+ * grammar, but `{input}` nodes THROW — a shadow-geometry expression must be a
+ * pure function of the resolved params, never of the frame clock.
+ */
+export function evalParamExpr(node, params) {
+    return evalNode(node, { animMs: 0, life: 0, elapsedMs: 0, params }, "params");
+}
+/**
+ * Evaluate a PER-PASS expression (`render.pass`): the same grammar over the
+ * resolved params plus the pass-geometry inputs (`targetMinDimPx` / `sdfRange`
+ * / `sdfViewBoxW`). Frame clocks (`animMs` / `life` / …) THROW — a pass
+ * expression is evaluated once per pass, not per frame.
+ */
+export function evalPassExpr(node, params, pass) {
+    return evalNode(node, { animMs: 0, life: 0, elapsedMs: 0, params, pass }, "pass");
+}
+//# sourceMappingURL=frame-expr.js.map

package/dist/framework/frame-expr.js.map

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