@dano796/react-reart 0.1.0

package/dist/components/engines/dragonFold.js

@@ -0,0 +1,166 @@
+/**
+ * Dragon Fold engine — framework-agnostic Canvas 2D renderer.
+ *
+ * Generates the dragon curve fractal (a.k.a. the Jurassic Park curve) via
+ * paper-folding iteration and renders it as a progressively self-drawing path.
+ * A glowing "head" crawls along the curve as older segments fade into the dark,
+ * leaving a trail that makes the self-similar geometry slowly visible. Each
+ * completed cycle slightly rotates the whole curve, layering the image.
+ */
+import { PerlinNoise, hexToRgb, lerp, rgba } from "../utils/noise";
+import { dragonFoldDefaults } from "../schemas";
+// ─── Dragon curve path generation ──────────────────────────────────────────
+function generateDragonTurns(depth) {
+    // true = right turn (CW), false = left turn (CCW)
+    // Paper-folding sequence: fold the paper right each time
+    let seq = [true];
+    for (let d = 1; d < depth; d++) {
+        const prev = [...seq];
+        seq.push(true);
+        for (let i = prev.length - 1; i >= 0; i--) {
+            seq.push(!prev[i]);
+        }
+    }
+    return seq;
+}
+function buildPath(turns, startX, startY, segLen, startAngle) {
+    const path = [{ x: startX, y: startY }];
+    let x = startX;
+    let y = startY;
+    // Direction as unit vector — 90° clockwise: (dx,dy) → (-dy,dx)
+    let dx = Math.cos(startAngle) * segLen;
+    let dy = Math.sin(startAngle) * segLen;
+    for (const right of turns) {
+        x += dx;
+        y += dy;
+        path.push({ x, y });
+        if (right) {
+            // clockwise: (dx,dy) → (-dy,dx)
+            [dx, dy] = [-dy, dx];
+        }
+        else {
+            // counter-clockwise: (dx,dy) → (dy,-dx)
+            [dx, dy] = [dy, -dx];
+        }
+    }
+    return path;
+}
+function normalizeAndCenter(path, W, H, margin, extraRotation) {
+    // Compute bounding box
+    let minX = Infinity, maxX = -Infinity, minY = Infinity, maxY = -Infinity;
+    for (const p of path) {
+        if (p.x < minX)
+            minX = p.x;
+        if (p.x > maxX)
+            maxX = p.x;
+        if (p.y < minY)
+            minY = p.y;
+        if (p.y > maxY)
+            maxY = p.y;
+    }
+    const bw = maxX - minX;
+    const bh = maxY - minY;
+    const scale = Math.min((W - margin * 2) / bw, (H - margin * 2) / bh);
+    const cx = W / 2;
+    const cy = H / 2;
+    const pcx = (minX + maxX) / 2;
+    const pcy = (minY + maxY) / 2;
+    const cos = Math.cos(extraRotation);
+    const sin = Math.sin(extraRotation);
+    return path.map((p) => {
+        const sx = (p.x - pcx) * scale;
+        const sy = (p.y - pcy) * scale;
+        return {
+            x: cx + sx * cos - sy * sin,
+            y: cy + sx * sin + sy * cos,
+        };
+    });
+}
+// ─── Public API ─────────────────────────────────────────────────────────────
+export function initDragonFold(width, height, params = {}) {
+    const p = { ...dragonFoldDefaults, ...params };
+    const noise = new PerlinNoise(p.seed);
+    const turns = generateDragonTurns(p.depth);
+    const rawPath = buildPath(turns, 0, 0, 10, 0);
+    const path = normalizeAndCenter(rawPath, width, height, width * 0.08, 0);
+    return {
+        path,
+        totalSegments: turns.length,
+        drawIndex: 0,
+        cycleRot: 0,
+        noise,
+        time: 0,
+        width,
+        height,
+    };
+}
+export function drawDragonFold(ctx, state, params = {}) {
+    const p = { ...dragonFoldDefaults, ...params };
+    const { path, width: W, height: H, noise } = state;
+    state.time += 0.01;
+    // Fade overlay — older drawn segments slowly disappear
+    ctx.fillStyle = rgba(10, 10, 18, p.fadeAlpha);
+    ctx.fillRect(0, 0, W, H);
+    if (path.length < 2)
+        return;
+    const totalSegs = state.totalSegments;
+    const prevIndex = state.drawIndex;
+    // Advance the drawing head
+    state.drawIndex = Math.min(state.drawIndex + Math.round(p.drawSpeed), totalSegs);
+    const headIndex = state.drawIndex;
+    // Draw only the newly added segments this frame (efficient)
+    if (headIndex > prevIndex && headIndex >= 1) {
+        const colorHead = hexToRgb(p.colorHead);
+        const colorTrail = hexToRgb(p.colorTrail);
+        // Draw new segments with head glow gradient
+        for (let i = prevIndex; i < headIndex; i++) {
+            if (i >= path.length - 1)
+                break;
+            const segT = (headIndex - i) / Math.min(p.drawSpeed * 4, 80);
+            // segT: 0 = head (newest), 1 = older
+            const t = Math.min(segT, 1);
+            const cr = lerp(colorHead.r, colorTrail.r, t);
+            const cg = lerp(colorHead.g, colorTrail.g, t);
+            const cb = lerp(colorHead.b, colorTrail.b, t);
+            const alpha = lerp(255, 120, t);
+            const lineW = lerp(p.lineWidth * 2.5, p.lineWidth, t);
+            ctx.strokeStyle = rgba(cr, cg, cb, alpha);
+            ctx.lineWidth = lineW;
+            ctx.lineCap = "round";
+            ctx.beginPath();
+            ctx.moveTo(path[i].x, path[i].y);
+            ctx.lineTo(path[i + 1].x, path[i + 1].y);
+            ctx.stroke();
+        }
+        // Head glow — pulse with noise
+        if (headIndex < path.length) {
+            const hp = path[headIndex];
+            const glowPulse = 1 + noise.get(state.time * 2, 0, 0) * 0.4;
+            const glowR = p.glowRadius * glowPulse;
+            const { r: cr, g: cg, b: cb } = colorHead;
+            for (let gr = glowR; gr > 0; gr -= glowR * 0.15) {
+                ctx.fillStyle = rgba(cr, cg, cb, ((gr / glowR) * 80) | 0);
+                ctx.beginPath();
+                ctx.arc(hp.x, hp.y, gr, 0, Math.PI * 2);
+                ctx.fill();
+            }
+        }
+    }
+    // Cycle complete: rebuild path with incremental rotation
+    if (state.drawIndex >= totalSegs) {
+        state.drawIndex = 0;
+        state.cycleRot += p.cycleRotation;
+        const turns = generateDragonTurns(p.depth);
+        const rawPath = buildPath(turns, 0, 0, 10, 0);
+        const newPath = normalizeAndCenter(rawPath, W, H, W * 0.08, state.cycleRot);
+        state.path.length = 0;
+        for (const pt of newPath)
+            state.path.push(pt);
+    }
+}
+export function resetDragonFold(ctx, state, params = {}) {
+    ctx.fillStyle = "rgb(10,10,18)";
+    ctx.fillRect(0, 0, state.width, state.height);
+    return initDragonFold(state.width, state.height, params);
+}
+//# sourceMappingURL=dragonFold.js.map

package/dist/components/engines/dragonFold.js.map

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

package/dist/components/engines/emberCascade.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Ember Cascade Engine
+ * Thermal particle system with turbulent ascent and temperature-based color gradient
+ */
+import { PerlinNoise, SeededRandom } from "../utils/noise";
+export interface EmberCascadeParams {
+    seed: number;
+    particleCount: number;
+    sourceCount: number;
+    riseSpeed: number;
+    turbulence: number;
+    glowSize: number;
+    bgColor: string;
+    hotColor: string;
+    midColor: string;
+    coolColor: string;
+}
+interface Particle {
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+    age: number;
+    maxAge: number;
+    size: number;
+}
+interface Source {
+    x: number;
+    y: number;
+}
+export interface EmberCascadeState {
+    particles: Particle[];
+    sources: Source[];
+    noise: PerlinNoise;
+    rng: SeededRandom;
+    time: number;
+    width: number;
+    height: number;
+    needsClear?: boolean;
+}
+export declare function initEmberCascade(width: number, height: number, params: EmberCascadeParams): EmberCascadeState;
+export declare function drawEmberCascade(ctx: CanvasRenderingContext2D, state: EmberCascadeState, params: EmberCascadeParams): void;
+export declare function resetEmberCascade(state: EmberCascadeState, params: EmberCascadeParams): void;
+export {};
+//# sourceMappingURL=emberCascade.d.ts.map

package/dist/components/engines/emberCascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emberCascade.d.ts","sourceRoot":"","sources":["../../../src/components/engines/emberCascade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AAEjF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,QAAQ;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,MAAM;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,YAAY,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,kBAAkB,GACzB,iBAAiB,CA+BnB;AAiCD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAiFN;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,kBAAkB,GACzB,IAAI,CAUN"}

package/dist/components/engines/emberCascade.js

@@ -0,0 +1,137 @@
+/**
+ * Ember Cascade Engine
+ * Thermal particle system with turbulent ascent and temperature-based color gradient
+ */
+import { PerlinNoise, SeededRandom, hexToRgb, lerp, rgba } from "../utils/noise";
+export function initEmberCascade(width, height, params) {
+    const rng = new SeededRandom(params.seed);
+    const noise = new PerlinNoise(params.seed);
+    // Create source points
+    const sources = [];
+    for (let i = 0; i < params.sourceCount; i++) {
+        sources.push({
+            x: rng.random() * (width * 0.7) + width * 0.15,
+            y: rng.random() * (height * 0.26) + height * 0.62,
+        });
+    }
+    // Create particles
+    const particles = [];
+    for (let i = 0; i < params.particleCount; i++) {
+        const src = sources[Math.floor(rng.random() * sources.length)];
+        const maxAge = (rng.random() * 120 + 70) * lerp(1.4, 0.55, (params.riseSpeed - 0.2) / 2.8);
+        const pt = {
+            x: src.x + (rng.random() * 2 - 1) * 28,
+            y: src.y + (rng.random() * 2 - 1) * 10,
+            vx: (rng.random() * 2 - 1) * 0.5,
+            vy: -(rng.random() * 2.2 + 1.6) * params.riseSpeed,
+            age: Math.floor(rng.random() * maxAge),
+            maxAge,
+            size: (rng.random() * 5 + 2) * params.glowSize,
+        };
+        particles.push(pt);
+    }
+    return { particles, sources, noise, rng, time: 0, width, height };
+}
+function getColor(t, hot, mid, cool) {
+    let r, g, b, a;
+    if (t < 0.15) {
+        const f = t / 0.15;
+        r = lerp(255, hot.r, f);
+        g = lerp(255, hot.g, f);
+        b = lerp(255, hot.b, f);
+        a = lerp(0, 225, t / 0.15);
+    }
+    else if (t < 0.5) {
+        const f = (t - 0.15) / 0.35;
+        r = lerp(hot.r, mid.r, f);
+        g = lerp(hot.g, mid.g, f);
+        b = lerp(hot.b, mid.b, f);
+        a = 215;
+    }
+    else {
+        const f = (t - 0.5) / 0.5;
+        r = lerp(mid.r, cool.r, f);
+        g = lerp(mid.g, cool.g, f);
+        b = lerp(mid.b, cool.b, f);
+        a = lerp(215, 0, f);
+    }
+    return { r, g, b, a };
+}
+export function drawEmberCascade(ctx, state, params) {
+    const { particles, sources, noise, rng, time } = state;
+    // Get actual canvas dimensions (accounting for device pixel ratio)
+    const width = ctx.canvas.width;
+    const height = ctx.canvas.height;
+    const bg = hexToRgb(params.bgColor);
+    // Clear canvas completely if needed (on reset)
+    if (state.needsClear) {
+        ctx.fillStyle = rgba(bg.r, bg.g, bg.b, 255);
+        ctx.fillRect(0, 0, width, height);
+        state.needsClear = false;
+    }
+    // Fade background (alpha 20 out of 255 = ~0.078)
+    ctx.fillStyle = rgba(bg.r, bg.g, bg.b, 20);
+    ctx.fillRect(0, 0, width, height);
+    const hot = hexToRgb(params.hotColor);
+    const mid = hexToRgb(params.midColor);
+    const cool = hexToRgb(params.coolColor);
+    // Update and draw particles
+    for (let i = 0; i < particles.length; i++) {
+        const pt = particles[i];
+        pt.age++;
+        // Apply noise-based turbulence
+        const nx = noise.get(pt.x * 0.006, pt.y * 0.006, time * 0.013);
+        const ny = noise.get(pt.x * 0.006 + 500, pt.y * 0.006 + 500, time * 0.013);
+        pt.vx += (nx - 0.5) * params.turbulence * 0.22;
+        pt.vy += (ny - 0.5) * params.turbulence * 0.09 - 0.04;
+        // Apply drag
+        pt.vx *= 0.96;
+        pt.vy *= 0.97;
+        // Update position
+        pt.x += pt.vx;
+        pt.y += pt.vy;
+        pt.size *= 0.999;
+        // Respawn if dead
+        if (pt.age >= pt.maxAge || pt.y < -30 || pt.size < 0.4) {
+            const src = sources[Math.floor(rng.random() * sources.length)];
+            pt.x = src.x + (rng.random() * 2 - 1) * 28;
+            pt.y = src.y + (rng.random() * 2 - 1) * 10;
+            pt.vx = (rng.random() * 2 - 1) * 0.5;
+            pt.vy = -(rng.random() * 2.2 + 1.6) * params.riseSpeed;
+            pt.age = 0;
+            pt.maxAge = (rng.random() * 120 + 70) * lerp(1.4, 0.55, (params.riseSpeed - 0.2) / 2.8);
+            pt.size = (rng.random() * 5 + 2) * params.glowSize;
+            continue;
+        }
+        // Draw particle with glow
+        const t = pt.age / pt.maxAge;
+        const col = getColor(t, hot, mid, cool);
+        // Outer glow
+        ctx.fillStyle = rgba(col.r, col.g, col.b, col.a * 0.22);
+        ctx.beginPath();
+        ctx.arc(pt.x, pt.y, pt.size * 5.5, 0, Math.PI * 2);
+        ctx.fill();
+        // Middle ring
+        ctx.fillStyle = rgba(col.r, col.g, col.b, col.a * 0.48);
+        ctx.beginPath();
+        ctx.arc(pt.x, pt.y, pt.size * 2.4, 0, Math.PI * 2);
+        ctx.fill();
+        // Core
+        ctx.fillStyle = rgba(col.r, col.g, col.b, col.a);
+        ctx.beginPath();
+        ctx.arc(pt.x, pt.y, pt.size * 0.9, 0, Math.PI * 2);
+        ctx.fill();
+    }
+    state.time++;
+}
+export function resetEmberCascade(state, params) {
+    const newState = initEmberCascade(state.width, state.height, params);
+    state.particles = newState.particles;
+    state.sources = newState.sources;
+    state.noise = newState.noise;
+    state.rng = newState.rng;
+    state.time = 0;
+    // Mark that we need to clear the canvas on next draw
+    state.needsClear = true;
+}
+//# sourceMappingURL=emberCascade.js.map

package/dist/components/engines/emberCascade.js.map

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

package/dist/components/engines/fibonacciVortex.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Fibonacci Vortex engine — golden spiral arms animated as particle streams.
+ *
+ * The mathematical heart is the golden spiral: r = k · φ^(θ / (π/2)), where
+ * each quarter-turn multiplies the radius by φ ≈ 1.618. Particles are
+ * distributed across N spiral arms (N taken from the Fibonacci sequence:
+ * 3, 5, 8, 13) and travel outward along their respective arms, wrapping
+ * back to the center when they reach maxRadius. The arms themselves rotate
+ * slowly — inner particles faster than outer ones, echoing phyllotaxis math
+ * without repeating the sunflower dot pattern.
+ *
+ * Multiple "bloom" origins can coexist; each owns its own particle cluster.
+ * Click to plant new blooms (oldest drops when the cap is reached). Mouse
+ * proximity locally bends particle paths through a gravitational softening
+ * function, creating fluid distortions without breaking the spiral form.
+ */
+import { SeededRandom } from "../utils/noise";
+export interface FibonacciVortexParams {
+    seed?: number;
+    /** Number of spiral arms per bloom (snapped to nearest Fibonacci number). */
+    numArms?: number;
+    /** Particles per arm. */
+    particlesPerArm?: number;
+    /** Global animation speed multiplier. */
+    speed?: number;
+    /** Mouse gravitational pull strength [0–1]. */
+    mouseStrength?: number;
+    /** Maximum simultaneous bloom centers. */
+    maxBlooms?: number;
+    /** Trail fade opacity per frame (lower = longer trails). */
+    trailOpacity?: number;
+    colorPrimary?: string;
+    colorSecondary?: string;
+    colorAccent?: string;
+}
+export declare const fibonacciVortexDefaults: Required<FibonacciVortexParams>;
+interface SpiralParticle {
+    /** Current θ value along the golden spiral — increases → particle moves outward. */
+    phase: number;
+    /** Arm index [0, numArms). Each arm adds (arm/numArms)·2π to the angle. */
+    arm: number;
+}
+interface BloomCenter {
+    x: number;
+    y: number;
+    particles: SpiralParticle[];
+    /** Overall rotation offset, grows slowly each frame. */
+    rotation: number;
+    /** Fade-in [0→1]. */
+    age: number;
+    maxR: number;
+    minR: number;
+    numArms: number;
+}
+export interface FibonacciVortexState {
+    blooms: BloomCenter[];
+    time: number;
+    width: number;
+    height: number;
+    rng: SeededRandom;
+}
+export declare function initFibonacciVortex(width: number, height: number, params?: FibonacciVortexParams): FibonacciVortexState;
+export declare function addBloom(state: FibonacciVortexState, x: number, y: number, params?: FibonacciVortexParams): void;
+export declare function drawFibonacciVortex(ctx: CanvasRenderingContext2D, state: FibonacciVortexState, params?: FibonacciVortexParams, mouse?: {
+    x: number;
+    y: number;
+}): void;
+export declare function resetFibonacciVortex(ctx: CanvasRenderingContext2D, state: FibonacciVortexState, params?: FibonacciVortexParams): FibonacciVortexState;
+export {};
+//# sourceMappingURL=fibonacciVortex.d.ts.map

package/dist/components/engines/fibonacciVortex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fibonacciVortex.d.ts","sourceRoot":"","sources":["../../../src/components/engines/fibonacciVortex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAwB,MAAM,gBAAgB,CAAC;AAWpE,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,qBAAqB,CAWnE,CAAC;AAIF,UAAU,cAAc;IACtB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;CACb;AAED,UAAU,WAAW;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,YAAY,CAAC;CACnB;AAsCD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,qBAA0B,GACjC,oBAAoB,CAMtB;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,oBAAoB,EAC3B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,GAAE,qBAA0B,GACjC,IAAI,CAIN;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,oBAAoB,EAC3B,MAAM,GAAE,qBAA0B,EAClC,KAAK,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,IAAI,CAiFN;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,oBAAoB,EAC3B,MAAM,GAAE,qBAA0B,GACjC,oBAAoB,CAItB"}

package/dist/components/engines/fibonacciVortex.js

@@ -0,0 +1,144 @@
+/**
+ * Fibonacci Vortex engine — golden spiral arms animated as particle streams.
+ *
+ * The mathematical heart is the golden spiral: r = k · φ^(θ / (π/2)), where
+ * each quarter-turn multiplies the radius by φ ≈ 1.618. Particles are
+ * distributed across N spiral arms (N taken from the Fibonacci sequence:
+ * 3, 5, 8, 13) and travel outward along their respective arms, wrapping
+ * back to the center when they reach maxRadius. The arms themselves rotate
+ * slowly — inner particles faster than outer ones, echoing phyllotaxis math
+ * without repeating the sunflower dot pattern.
+ *
+ * Multiple "bloom" origins can coexist; each owns its own particle cluster.
+ * Click to plant new blooms (oldest drops when the cap is reached). Mouse
+ * proximity locally bends particle paths through a gravitational softening
+ * function, creating fluid distortions without breaking the spiral form.
+ */
+import { SeededRandom, hexToRgb, lerp, rgba } from "../utils/noise";
+/** b in r = k·e^(b·θ) — one quarter-turn (π/2) grows radius by φ */
+const PHI = 1.6180339887;
+const SPIRAL_B = Math.log(PHI) / (Math.PI / 2);
+/** Fibonacci arm counts available for selection */
+const FIB_ARM_COUNTS = [3, 5, 8, 13];
+export const fibonacciVortexDefaults = {
+    seed: 33771,
+    numArms: 8,
+    particlesPerArm: 90,
+    speed: 1.0,
+    mouseStrength: 0.14,
+    maxBlooms: 4,
+    trailOpacity: 20,
+    colorPrimary: "#f5c842",
+    colorSecondary: "#e05a20",
+    colorAccent: "#8c42f5",
+};
+// ── Helpers ────────────────────────────────────────────────────────────────────
+function snapToFibArms(n) {
+    return FIB_ARM_COUNTS.reduce((prev, curr) => Math.abs(curr - n) < Math.abs(prev - n) ? curr : prev);
+}
+function createBloom(x, y, p, rng, W, H) {
+    const maxR = Math.min(W, H) * 0.46;
+    const minR = 5;
+    const numArms = snapToFibArms(p.numArms);
+    const phaseMax = Math.log(maxR / minR) / SPIRAL_B;
+    const particles = [];
+    for (let arm = 0; arm < numArms; arm++) {
+        for (let j = 0; j < p.particlesPerArm; j++) {
+            particles.push({ phase: rng.range(0, phaseMax), arm });
+        }
+    }
+    return {
+        x, y, particles,
+        rotation: rng.range(0, Math.PI * 2),
+        age: 0, maxR, minR, numArms,
+    };
+}
+// ── Public API ────────────────────────────────────────────────────────────────
+export function initFibonacciVortex(width, height, params = {}) {
+    const p = { ...fibonacciVortexDefaults, ...params };
+    const rng = new SeededRandom(p.seed);
+    const bloom = createBloom(width / 2, height / 2, p, rng, width, height);
+    bloom.age = 1; // center bloom starts fully visible
+    return { blooms: [bloom], time: 0, width, height, rng };
+}
+export function addBloom(state, x, y, params = {}) {
+    const p = { ...fibonacciVortexDefaults, ...params };
+    state.blooms.push(createBloom(x, y, p, state.rng, state.width, state.height));
+    if (state.blooms.length > p.maxBlooms)
+        state.blooms.shift();
+}
+export function drawFibonacciVortex(ctx, state, params = {}, mouse) {
+    const p = { ...fibonacciVortexDefaults, ...params };
+    const { width: W, height: H } = state;
+    const dt = 0.016 * p.speed;
+    state.time += dt;
+    // Trail fade
+    ctx.fillStyle = rgba(6, 4, 16, p.trailOpacity);
+    ctx.fillRect(0, 0, W, H);
+    const c1 = hexToRgb(p.colorPrimary);
+    const c2 = hexToRgb(p.colorSecondary);
+    const c3 = hexToRgb(p.colorAccent);
+    const scale = W / 800;
+    ctx.globalCompositeOperation = "screen";
+    for (const bloom of state.blooms) {
+        bloom.age = Math.min(bloom.age + 0.022, 1.0);
+        bloom.rotation += dt * 0.13;
+        const phaseMax = Math.log(bloom.maxR / bloom.minR) / SPIRAL_B;
+        for (const pt of bloom.particles) {
+            // Particles accelerate slightly as they spiral outward
+            const tNorm = pt.phase / phaseMax;
+            pt.phase += dt * (0.6 + 0.6 * tNorm);
+            if (pt.phase > phaseMax)
+                pt.phase -= phaseMax;
+            const r = bloom.minR * Math.exp(SPIRAL_B * pt.phase);
+            const armOffset = (pt.arm / bloom.numArms) * Math.PI * 2;
+            const angle = bloom.rotation + armOffset + pt.phase;
+            let px = bloom.x + Math.cos(angle) * r;
+            let py = bloom.y + Math.sin(angle) * r;
+            // Mouse gravitational pull
+            if (mouse) {
+                const dx = mouse.x - px;
+                const dy = mouse.y - py;
+                const dist = Math.hypot(dx, dy);
+                if (dist < 160) {
+                    const pull = p.mouseStrength * (1 - dist / 160);
+                    px += dx * pull;
+                    py += dy * pull;
+                }
+            }
+            // Color: primary (inner) → secondary → accent (outer)
+            let cr, cg, cb;
+            if (tNorm < 0.5) {
+                cr = lerp(c1.r, c2.r, tNorm * 2);
+                cg = lerp(c1.g, c2.g, tNorm * 2);
+                cb = lerp(c1.b, c2.b, tNorm * 2);
+            }
+            else {
+                cr = lerp(c2.r, c3.r, (tNorm - 0.5) * 2);
+                cg = lerp(c2.g, c3.g, (tNorm - 0.5) * 2);
+                cb = lerp(c2.b, c3.b, (tNorm - 0.5) * 2);
+            }
+            const alpha = Math.floor(bloom.age * lerp(230, 70, tNorm));
+            const dotR = Math.max(lerp(2.4, 0.7, tNorm) * scale, 0.5);
+            ctx.beginPath();
+            ctx.arc(px, py, dotR, 0, Math.PI * 2);
+            ctx.fillStyle = rgba(cr, cg, cb, alpha);
+            ctx.fill();
+        }
+        // Center glow
+        const glow = ctx.createRadialGradient(bloom.x, bloom.y, 0, bloom.x, bloom.y, 22 * scale);
+        glow.addColorStop(0, rgba(c1.r, c1.g, c1.b, Math.floor(bloom.age * 130)));
+        glow.addColorStop(1, rgba(c1.r, c1.g, c1.b, 0));
+        ctx.fillStyle = glow;
+        ctx.beginPath();
+        ctx.arc(bloom.x, bloom.y, 22 * scale, 0, Math.PI * 2);
+        ctx.fill();
+    }
+    ctx.globalCompositeOperation = "source-over";
+}
+export function resetFibonacciVortex(ctx, state, params = {}) {
+    ctx.fillStyle = "rgb(6,4,16)";
+    ctx.fillRect(0, 0, state.width, state.height);
+    return initFibonacciVortex(state.width, state.height, params);
+}
+//# sourceMappingURL=fibonacciVortex.js.map

package/dist/components/engines/fibonacciVortex.js.map

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

package/dist/components/engines/flowCurrents.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Flow Currents engine — framework-agnostic Canvas 2D renderer.
+ *
+ * Faithful port of the p5.js implementation in kinetic-arcana-gallery.html.
+ * Thousands of particles trace Perlin-noise vector fields, leaving
+ * color-burned trails that form organic density maps.
+ */
+import { PerlinNoise, SeededRandom } from "../utils/noise";
+import type { FlowCurrentsParams } from "../schemas";
+interface Particle {
+    x: number;
+    y: number;
+    prevX: number;
+    prevY: number;
+    life: number;
+    maxLife: number;
+    age: number;
+    speed: number;
+}
+export interface FlowCurrentsState {
+    particles: Particle[];
+    noise: PerlinNoise;
+    rng: SeededRandom;
+    z: number;
+    width: number;
+    height: number;
+    initialized: boolean;
+}
+export declare function initFlowCurrents(width: number, height: number, params?: FlowCurrentsParams): FlowCurrentsState;
+export declare function drawFlowCurrents(ctx: CanvasRenderingContext2D, state: FlowCurrentsState, params?: FlowCurrentsParams): void;
+/** Full reset — call when structural params change (count, seed). */
+export declare function resetFlowCurrents(ctx: CanvasRenderingContext2D, state: FlowCurrentsState, params?: FlowCurrentsParams): FlowCurrentsState;
+export {};
+//# sourceMappingURL=flowCurrents.d.ts.map

package/dist/components/engines/flowCurrents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowCurrents.d.ts","sourceRoot":"","sources":["../../../src/components/engines/flowCurrents.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAoC,MAAM,gBAAgB,CAAC;AAC7F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGrD,UAAU,QAAQ;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,YAAY,CAAC;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,kBAAuB,GAC9B,iBAAiB,CAqBnB;AAED,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,iBAAiB,EACxB,MAAM,GAAE,kBAAuB,GAC9B,IAAI,CA6DN;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,wBAAwB,EAC7B,KAAK,EAAE,iBAAiB,EACxB,MAAM,GAAE,kBAAuB,GAC9B,iBAAiB,CAKnB"}