@dopaminefx/core 0.1.0

package/dist/framework/load-effect.d.ts

@@ -0,0 +1,77 @@
+/**
+ * `loadEffect()` — the public, no-code entry point for arbitrary `.dope` effects.
+ *
+ * A host drops in a `.dope` (a parsed object, a JSON string, or a `.dope` zip),
+ * optionally patches it (clamp control ranges, pin a brand palette, swap an
+ * outline path), and gets back a registered `EffectFactory` playable via
+ * `play()` / `prepare()`. The effect binds to a BUNDLED render program
+ * (framework/programs.ts) referenced by the doc's
+ * `render.backends.webgl2.shader.program` key — the format carries data + a
+ * program key; the runtime owns the GLSL. No new shader/renderer code is needed
+ * to ship a recolored / re-iconed / retimed variant of a bundled effect.
+ *
+ * Overrides are a shallow JSON-pointer-style patch applied to the parsed doc,
+ * then the merged doc is RE-VALIDATED (parseDope: magic/version + the
+ * standalone guard) so a host can't push the effect into an invalid or
+ * non-self-contained state. Swapped outline paths are re-baked to an SDF here so
+ * the runtime still only samples.
+ */
+import { type DopeDoc } from "./loader.js";
+import type { OKLCH } from "../engine/color.js";
+import type { EffectFactory } from "./effect.js";
+/** Host customization patch — all no-code from the host's POV (docs §9.1). */
+export interface LoadOverrides {
+    /**
+     * Clamp/retune a control's range or default, by control name. The loader
+     * re-validates that default ∈ [min, max] after merging.
+     * e.g. `{ intensity: { max: 0.8, default: 0.6 } }`.
+     */
+    controls?: Record<string, {
+        min?: number;
+        max?: number;
+        default?: number | null;
+    }>;
+    /**
+     * THEME: replace the generated palette with three explicit OKLCH brand stops
+     * (the base-hue rng is still consumed, so per-fire scatter is unchanged), OR
+     * pin `seed` to lock the generated palette. `palette` wins over `seed`.
+     */
+    palette?: [OKLCH, OKLCH, OKLCH];
+    /** THEME: pin the seed so the generated palette reproduces every fire. */
+    seed?: number;
+    /**
+     * RESKIN: swap an outline's SVG path by outline name; re-baked to an SDF here.
+     * e.g. `{ checkmark: "M5 55 L40 88 L95 8" }`.
+     */
+    outlines?: Record<string, string>;
+}
+export interface LoadEffectOptions {
+    /** Register the effect under this name (default: the doc's `id`). */
+    name?: string;
+    /** Host customization patch (§9.1). */
+    overrides?: LoadOverrides;
+    /** SDF bake resolution for swapped outlines (default 64). */
+    sdfSize?: number;
+    /** SDF bake distance range in author units for swapped outlines (default 18). */
+    sdfRange?: number;
+}
+/** A loaded, registered effect ready to fire. */
+export interface LoadedEffect {
+    /** The registered name (use with `play(name, …)`). */
+    readonly name: string;
+    /** The registered factory. */
+    readonly factory: EffectFactory;
+    /** The merged, validated `.dope` document. */
+    readonly doc: DopeDoc;
+}
+/**
+ * Parse + (optionally) patch a `.dope`, bind it to its bundled render program,
+ * register it, and return a playable factory. The merged doc is re-validated.
+ */
+export declare function loadEffectSync(src: string | object, opts?: LoadEffectOptions): LoadedEffect;
+/**
+ * Public async `loadEffect`. Accepts a parsed doc, a JSON string, or a `.dope`
+ * zip (Uint8Array/ArrayBuffer/Blob). Resolves to the registered, playable effect.
+ */
+export declare function loadEffect(src: string | object | Uint8Array | ArrayBuffer | Blob, opts?: LoadEffectOptions): Promise<LoadedEffect>;
+//# sourceMappingURL=load-effect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-effect.d.ts","sourceRoot":"","sources":["../../src/framework/load-effect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAa,KAAK,OAAO,EAAoB,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAKhD,OAAO,KAAK,EAAiB,aAAa,EAAgB,MAAM,aAAa,CAAC;AAW9E,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IACnF;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAChC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AA+CD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GAAG,MAAM,EACpB,IAAI,GAAE,iBAAsB,GAC3B,YAAY,CAqDd;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,IAAI,EACtD,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,YAAY,CAAC,CASvB"}

package/dist/framework/load-effect.js

@@ -0,0 +1,135 @@
+/**
+ * `loadEffect()` — the public, no-code entry point for arbitrary `.dope` effects.
+ *
+ * A host drops in a `.dope` (a parsed object, a JSON string, or a `.dope` zip),
+ * optionally patches it (clamp control ranges, pin a brand palette, swap an
+ * outline path), and gets back a registered `EffectFactory` playable via
+ * `play()` / `prepare()`. The effect binds to a BUNDLED render program
+ * (framework/programs.ts) referenced by the doc's
+ * `render.backends.webgl2.shader.program` key — the format carries data + a
+ * program key; the runtime owns the GLSL. No new shader/renderer code is needed
+ * to ship a recolored / re-iconed / retimed variant of a bundled effect.
+ *
+ * Overrides are a shallow JSON-pointer-style patch applied to the parsed doc,
+ * then the merged doc is RE-VALIDATED (parseDope: magic/version + the
+ * standalone guard) so a host can't push the effect into an invalid or
+ * non-self-contained state. Swapped outline paths are re-baked to an SDF here so
+ * the runtime still only samples.
+ */
+import { parseDope } from "./loader.js";
+import { bakeSdf } from "../engine/sdf.js";
+import { getProgram, programNames } from "./programs.js";
+import { registerEffect } from "./registry.js";
+import { resolveDopeParams } from "./loader.js";
+const REMOTE_RE = /^(?:[a-z][a-z0-9+.-]*:)?\/\//i;
+/** Apply control range/default overrides, validating default ∈ [min, max]. */
+function applyControlOverrides(doc, overrides) {
+    const controls = doc.controls;
+    if (!controls)
+        throw new Error("dope: cannot override controls — doc has no `controls` block");
+    for (const [name, patch] of Object.entries(overrides)) {
+        const c = controls[name];
+        if (!c)
+            throw new Error(`dope: cannot override unknown control "${name}"`);
+        if (patch.min !== undefined)
+            c.min = patch.min;
+        if (patch.max !== undefined)
+            c.max = patch.max;
+        if (patch.default !== undefined)
+            c.default = patch.default;
+        const lo = typeof c.min === "number" ? c.min : -Infinity;
+        const hi = typeof c.max === "number" ? c.max : Infinity;
+        if (typeof c.min === "number" && typeof c.max === "number" && c.min > c.max) {
+            throw new Error(`dope: control "${name}" override has min > max`);
+        }
+        if (typeof c.default === "number" && (c.default < lo || c.default > hi)) {
+            throw new Error(`dope: control "${name}" default ${c.default} out of range [${lo}, ${hi}]`);
+        }
+    }
+}
+/** Swap outline svgPaths and re-bake their SDFs (the runtime still only samples). */
+function applyOutlineOverrides(doc, outlines, size, range) {
+    const geo = doc.geometry;
+    if (!geo?.outlines)
+        throw new Error("dope: cannot swap outline — doc has no `geometry.outlines`");
+    const viewBox = geo.viewBox ?? [0, 0, 100, 100];
+    for (const [name, svgPath] of Object.entries(outlines)) {
+        const o = geo.outlines[name];
+        if (!o)
+            throw new Error(`dope: cannot swap unknown outline "${name}"`);
+        if (REMOTE_RE.test(svgPath) || svgPath.trim().startsWith("/")) {
+            throw new Error(`dope: swapped outline path must be a self-contained svgPath, not a ref`);
+        }
+        o.svgPath = svgPath;
+        o.sdf = bakeSdf(svgPath, viewBox, size, range);
+        o.source = "baked-sdf";
+    }
+}
+/**
+ * Parse + (optionally) patch a `.dope`, bind it to its bundled render program,
+ * register it, and return a playable factory. The merged doc is re-validated.
+ */
+export function loadEffectSync(src, opts = {}) {
+    // Parse + validate the base doc first (rejects remote/absolute refs).
+    let doc = parseDope(src);
+    // Deep-clone so overrides never mutate a caller's object (and so re-bakes land
+    // on a private copy).
+    doc = JSON.parse(JSON.stringify(doc));
+    const ov = opts.overrides ?? {};
+    if (ov.controls)
+        applyControlOverrides(doc, ov.controls);
+    if (ov.outlines) {
+        applyOutlineOverrides(doc, ov.outlines, opts.sdfSize ?? 64, opts.sdfRange ?? 18);
+    }
+    // Re-validate the merged doc (magic/version + standalone guard). A swapped
+    // outline that smuggled a remote/absolute ref is rejected here.
+    doc = parseDope(doc);
+    // Resolve the bundled render program the doc references.
+    const backends = (doc.render.backends ?? {});
+    const programKey = backends.webgl2?.shader?.program;
+    if (!programKey) {
+        throw new Error("dope: render.backends.webgl2.shader.program is required for loadEffect");
+    }
+    const program = getProgram(programKey);
+    if (!program) {
+        throw new Error(`dope: unknown render program "${programKey}". Known: ${programNames().join(", ") || "import the effect that registers it"}`);
+    }
+    const name = opts.name ?? doc.id;
+    const seed = ov.seed;
+    const paletteOverride = ov.palette;
+    const factory = {
+        name,
+        castsShadow: program.castsShadow,
+        reducedMotion: program.reducedMotion,
+        resolve(feeling) {
+            // A pinned override seed wins over the per-fire seed (locks the palette).
+            const f = { ...feeling, seed: seed ?? feeling.seed };
+            const numeric = resolveDopeParams(doc, f, program.consts, program.scatterKey, paletteOverride);
+            return program.composeParams
+                ? program.composeParams(numeric, f)
+                : numeric;
+        },
+        create(params, ctx) {
+            return program.create(params, ctx);
+        },
+    };
+    registerEffect(factory);
+    return { name, factory, doc };
+}
+/**
+ * Public async `loadEffect`. Accepts a parsed doc, a JSON string, or a `.dope`
+ * zip (Uint8Array/ArrayBuffer/Blob). Resolves to the registered, playable effect.
+ */
+export async function loadEffect(src, opts = {}) {
+    if (src instanceof Blob)
+        src = new Uint8Array(await src.arrayBuffer());
+    if (src instanceof ArrayBuffer)
+        src = new Uint8Array(src);
+    if (src instanceof Uint8Array) {
+        const { readDopeZip } = await import("./dope-zip.js");
+        const json = await readDopeZip(src);
+        return loadEffectSync(json, opts);
+    }
+    return loadEffectSync(src, opts);
+}
+//# sourceMappingURL=load-effect.js.map

package/dist/framework/load-effect.js.map

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

package/dist/framework/loader.d.ts

@@ -0,0 +1,309 @@
+/**
+ * `.dope` effect loader.
+ *
+ * Parses a `.dope` JSON document (per docs/effect-format.md) and evaluates its
+ * `controls → render.params` mapping grammar, the OKLCH golden-angle palette,
+ * and the per-mood baseline table into the SAME flat render-param bag the engine
+ * consumes. Shader bodies stay referenced GLSL (the format references them); the
+ * loader is NOT a GLSL transpiler.
+ *
+ * The single load-bearing invariant (the correctness anchor): the PRNG is
+ * consumed in the SAME order as the legacy `resolve*Params` — `buildPalette`
+ * draws the base hue first (one `rng()` inside it), then the per-fire scatter
+ * (`rng() * 1000`). So a pinned seed reproduces the legacy output byte-for-byte;
+ * a vitest asserts this across a mood × intensity × whimsy × seed grid.
+ *
+ * The grammar is intentionally tiny + non-Turing-complete (no loops, no user
+ * functions) so it is safe to evaluate from an untrusted file and trivial to
+ * port to Swift for the Metal backend.
+ */
+import { type OKLCH, type RGB } from "../engine/color.js";
+import type { BakedSdf } from "../engine/sdf.js";
+import type { FrameExprNode } from "./frame-expr.js";
+/**
+ * The per-frame logic spec (`tempo.frame`): the datafied form of an effect's
+ * hand-written `frame()` hook. `amp` feeds shadowGeometry; `extras` are keyed by
+ * the CANONICAL extra name (matching `binding.extras[].name`) and map to each
+ * platform's uniform via the binding contract.
+ */
+export interface DopeFrameSpec {
+    amp: FrameExprNode;
+    extras?: Record<string, FrameExprNode>;
+}
+/**
+ * The continuous-loop contract (`tempo.loop`): the effect repeats seamlessly
+ * with period `periodMs`. `parseDope` validates the two seam invariants that
+ * used to be per-effect convention: the period tiles the "animate on twos"
+ * grid (unless `snapAligned` is false) and every baseline `durationMs` is a
+ * whole number of periods — so the frame at `t == durationMs` matches `t == 0`
+ * at every whimsy. Runners surface the standard periodic clock uniforms
+ * `uLoopS` / `uPhase` (and the `loopS` / `phase` frame-expr inputs) from it,
+ * and conductors re-arm at `durationMs` instead of tearing down.
+ */
+export interface DopeLoopSpec {
+    /** The seamless loop period, ms. */
+    periodMs: number;
+    /**
+     * Whether `periodMs` must be a whole number of `NPR_TIME_STEP_MS` steps so
+     * the "animate on twos" snapped clock is also periodic. Default true.
+     */
+    snapAligned?: boolean;
+}
+/**
+ * The cross-platform uniform-binding contract. SHIPS in the portable doc: the
+ * runtime derives which resolved params bind to which shader uniforms from it
+ * (and the toolchain consumes it for the Metal struct codegen).
+ */
+export interface DopeBinding {
+    note?: string;
+    /** `render.params` (or resolved-bag) names that are NOT shader uniforms. */
+    excludeParams?: string[];
+    /** The per-fire seed-keyed scatter field (auroraSeed / inkSeed / …). */
+    scatterKey?: string | null;
+    /** The web uniform the scatter binds to (absent = not a shader uniform). */
+    scatterWeb?: string;
+    /** Per-frame/host extras (filled by `tempo.frame.extras` or host hooks). */
+    extras?: Array<{
+        name: string;
+        type?: string;
+        web?: string;
+        note?: string;
+    }>;
+    /** Texture samplers the shader reads (see {@link DopeSampler}). */
+    samplers?: Array<string | DopeSampler>;
+    /** CPU-precomputed per-frame ARRAYS the shader reads (see {@link DopeFrameArray}). */
+    arrays?: DopeFrameArray[];
+}
+/**
+ * One per-frame ARRAY in the binding contract — the cross-platform transport
+ * for CPU-precomputed frame geometry (lightning's bolt polyline). The web and
+ * GL runtimes bind it by NAME as a `uniform vecN <web>[…]` array filled by the
+ * `frameArrays` seam; Metal binds it as a `constant floatN *` FRAGMENT BUFFER
+ * at index `buffer` (the toolchain's GLSL→MSL transpiler + the generated
+ * factory shells consume this entry).
+ */
+export interface DopeFrameArray {
+    /** The canonical name — the field of the logic module's returned bundle. */
+    name: string;
+    /** The web/GL uniform array name (e.g. `uVerts`). */
+    web: string;
+    /** Vector component count (2 | 3 | 4). */
+    size: number;
+    /** The Metal fragment buffer index (>= 1; 0 is the uniform struct). */
+    buffer?: number;
+    note?: string;
+}
+/**
+ * One texture sampler in the binding contract. Beyond the binding names, a
+ * sampler may declare a DECLARATIVE SDF source: `outline` names a
+ * `geometry.outlines` entry whose baked SDF the runtime decodes + binds at
+ * texture unit `texture` (web; the native runtimes keep their analytic
+ * fallback), and `on` names the `binding.extras` flag the runner flips to 1
+ * when the texture is bound (left at 0 — the analytic path — when the SDF is
+ * absent or undecodable).
+ */
+export interface DopeSampler {
+    /** The web sampler uniform name (e.g. `uSdfTex`). */
+    web: string;
+    /** The canonical/MSL argument name (e.g. `sdfTex`). */
+    name?: string;
+    /** The texture unit it binds at (texture(0) is the panel slot). */
+    texture?: number;
+    /** A `geometry.outlines` key whose baked SDF backs this sampler. */
+    outline?: string;
+    /** The canonical `binding.extras` name of the sampler's "on" flag. */
+    on?: string;
+    note?: string;
+}
+/** A `.dope` document (the parts the loader consumes — others are ignored). */
+export interface DopeDoc {
+    fmt: string;
+    v: string;
+    id: string;
+    meta?: {
+        name?: string;
+        description?: string;
+        tags?: string[];
+    };
+    palette: DopePalette;
+    tempo: {
+        durationMs?: DopeParamSpec;
+        /** Continuous-loop contract (seamless period); see {@link DopeLoopSpec}. */
+        loop?: DopeLoopSpec;
+        /** Per-frame logic (amp + extras) as frame-expression trees. */
+        frame?: DopeFrameSpec;
+        /** Reduced-motion peak/hold the factories used to hardcode. */
+        reducedMotion?: {
+            peakMs?: number;
+            holdMs?: number;
+        };
+    };
+    render: {
+        params: Record<string, DopeParamSpec>;
+        /** Shadow occluder height: a params-only frame expression (or a bare number). */
+        shadowHeightFrac?: FrameExprNode;
+        /**
+         * PER-PASS scalar uniforms, keyed by the CANONICAL extra name (matching
+         * `binding.extras[].name`): expressions over the resolved params + the
+         * pass-geometry inputs (`targetMinDimPx` / `sdfRange` / `sdfViewBoxW`),
+         * evaluated once per pass by `evalPassExpr` (frame clocks throw).
+         */
+        pass?: Record<string, FrameExprNode>;
+        /** Loop-cap consts the param mapping's clampMax/clampMin reference. */
+        consts?: Record<string, number>;
+        /**
+         * The dynamic PANEL the host draws each frame and the shader samples
+         * (`sampler` must appear in `binding.samplers`; `texture` defaults to 0 —
+         * the cross-platform panel slot). The draw itself stays code (the
+         * per-platform panel-draw seam); only the wiring is data.
+         */
+        panel?: {
+            sampler: string;
+            texture?: number;
+            note?: string;
+        };
+        /**
+         * Runner config: whether the shader reads `uOrigin`, and the clock
+         * stepping — `"none"` declares the effect's clock NEVER snaps "on twos"
+         * (the Canvas2D-panel runner semantics; panel geometry is hand-drawn, so
+         * snapping the clock would stutter it). Default: style-driven snapping.
+         */
+        config?: {
+            usesOrigin?: boolean;
+            stepping?: "none";
+        };
+        backends?: unknown;
+        fallbackOrder?: string[];
+    };
+    /** The uniform-binding contract (see {@link DopeBinding}). */
+    binding?: DopeBinding;
+    /** Per-mood baseline table (color + non-color baselines), keyed by mood name. */
+    baselines: Record<string, Record<string, number>>;
+    /** Outline geometry — icon paths + (after the pack/bake step) baked SDFs. */
+    geometry?: DopeGeometry;
+    /** Free-form per-effect content (word sets, tokens) consumed by renderers. */
+    content?: Record<string, unknown>;
+    /** Typography tables (mood→face + whimsy/intensity curves) for letter effects. */
+    typography?: Record<string, unknown>;
+}
+/** An outline entry: an authored `svgPath` and/or its baked SDF + a role tag. */
+export interface DopeOutline {
+    role?: string;
+    source?: string;
+    svgPath?: string;
+    /** Inline baked signed-distance field (a `data:` URI blob); see engine/sdf.ts. */
+    sdf?: BakedSdf;
+    note?: string;
+}
+export interface DopeGeometry {
+    kind?: string;
+    viewBox?: [number, number, number, number];
+    outlines?: Record<string, DopeOutline>;
+}
+/** Read a named outline from a doc's geometry, or undefined. */
+export declare function getOutline(doc: DopeDoc, name: string): DopeOutline | undefined;
+/**
+ * The mood a doc degrades to when asked for one it doesn't declare.
+ *
+ * Each effect declares its OWN moods (the success trio declares
+ * serene/celebratory/electric; the fail effect declares try-again/error/denied),
+ * so there is no single hardcoded fallback mood that exists for every effect.
+ * An effect's own default is, in order of preference:
+ *   1. its `controls.mood.default`, if that mood actually has a baseline, else
+ *   2. the first mood key in its `baselines` table.
+ * This keeps EVERY declared mood resolvable and makes an unknown mood degrade to
+ * the effect's own sensible default instead of throwing on a missing baseline.
+ */
+export declare function defaultMoodKey(doc: DopeDoc): string;
+interface DopePalette {
+    hueSpread: number;
+    lightness: {
+        baseline: string;
+        perStop: [number, number, number];
+    };
+    chroma: {
+        from: ExprNode;
+        perStop: [number, number, number];
+    };
+    /** Color register fields per mood: hueCenter, hueRange, lightness, chroma. */
+    perMood: Record<string, {
+        hueCenter: number;
+        hueRange: number;
+        lightness: number;
+        chroma: number;
+    }>;
+}
+interface DopeParamSpec {
+    type?: "float" | "int";
+    from: ExprNode;
+    clamp01?: boolean;
+    clampMax?: string;
+    clampMin?: string;
+}
+/** The mapping mini-grammar (§4.1) — an expression tree. */
+export type ExprNode = number | {
+    const: number;
+} | {
+    control: string;
+} | {
+    baseline: string;
+} | {
+    lerp: [string, number, number];
+} | {
+    mul: ExprNode[];
+} | {
+    add: ExprNode[];
+} | {
+    sub: ExprNode[];
+} | {
+    round: ExprNode;
+} | {
+    floor: ExprNode;
+} | {
+    mix: [ExprNode, ExprNode, string];
+} | {
+    max: ExprNode[];
+} | {
+    min: ExprNode[];
+};
+/** Evaluation context for the grammar. */
+export interface EvalCtx {
+    controls: Record<string, number>;
+    baseline: Record<string, number>;
+    consts: Record<string, number>;
+}
+/** Evaluate a grammar node to a number. Pure; matches mood.ts arithmetic. */
+export declare function evalExpr(node: ExprNode, ctx: EvalCtx): number;
+export interface DopeResolveInput {
+    mood: string;
+    intensity: number;
+    whimsy: number;
+    seed: number;
+}
+/**
+ * Resolve a `.dope` doc + a feeling into the flat render-param bag (palette,
+ * style, durationMs, seed, scatter seed, and every `render.params` entry). The
+ * `scatterKey` is the name the legacy code gave the per-fire scatter offset
+ * (`moteSeed` / `inkSeed` / `comicSeed`) so the output keys match exactly.
+ *
+ * RNG order (the parity anchor): baseHue via buildPalette FIRST, then the
+ * scatter `rng()*1000` — identical to `resolve*Params`.
+ */
+export declare function resolveDopeParams(doc: DopeDoc, input: DopeResolveInput, consts: Record<string, number>, scatterKey: string, 
+/**
+ * Host theme override: three explicit OKLCH stops that REPLACE the generated
+ * golden-angle palette (a pinned brand palette). The base-hue rng() is still
+ * consumed first, so the per-fire scatter offset stays identical to the
+ * generated path — pinning the palette never shifts the mote/spray layout.
+ */
+paletteOverride?: [OKLCH, OKLCH, OKLCH]): Record<string, number | RGB[] | number[]>;
+/**
+ * Parse + validate a `.dope` document from a JSON string or already-parsed
+ * object. Rejects a wrong/absent magic or major version, any external
+ * (remote / absolute-path) asset reference — a `.dope` must be self-contained —
+ * and a `tempo.loop` that breaks the seam invariants.
+ * (A fuller JSON-Schema validation lives in CI against effect-format.schema.json.)
+ */
+export declare function parseDope(src: string | object): DopeDoc;
+export {};
+//# sourceMappingURL=loader.d.ts.map

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

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