@joydle/juice-babylon 0.1.4 → 0.1.19

package/dist/ambient.d.ts

@@ -0,0 +1,127 @@
+import type { BabylonMesh, BabylonScene } from './types.js';
+export interface AmbientParticleOptions {
+    type: 'dust' | 'fireflies' | 'snow' | 'rain' | 'embers' | 'pollen';
+    density?: number;
+    wind?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    color?: number;
+    volume?: number;
+}
+export interface IdleBreathingOptions {
+    amplitude?: number;
+    speed?: number;
+    phase?: number;
+}
+/** Sine-wave scale pulse on a Babylon.js mesh. */
+export declare class IdleBreathing {
+    private _target;
+    private _amplitude;
+    private _speed;
+    private _phase;
+    private _baseScale;
+    private _t;
+    private _running;
+    constructor(target: BabylonMesh, opts?: IdleBreathingOptions);
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface FloatingMotionOptions {
+    bobHeight?: number;
+    bobSpeed?: number;
+    rotationDrift?: number;
+    phase?: number;
+}
+/** Gentle bob + rotation drift for Babylon.js meshes. */
+export declare class FloatingMotion {
+    private _target;
+    private _bobHeight;
+    private _bobSpeed;
+    private _rotationDrift;
+    private _phase;
+    private _baseY;
+    private _t;
+    private _running;
+    constructor(target: BabylonMesh, opts?: FloatingMotionOptions);
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface EnvironmentPulseOptions {
+    cycleDuration?: number;
+    warmColor?: number;
+    coolColor?: number;
+}
+/** Color temperature shift on Babylon.js mesh materials. */
+export declare class EnvironmentPulse {
+    private _targets;
+    private _cycleDuration;
+    private _warmR;
+    private _warmG;
+    private _warmB;
+    private _coolR;
+    private _coolG;
+    private _coolB;
+    private _t;
+    private _running;
+    constructor(targets: BabylonMesh[], opts?: EnvironmentPulseOptions);
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+interface Particle3D {
+    x: number;
+    y: number;
+    z: number;
+    vx: number;
+    vy: number;
+    vz: number;
+    life: number;
+    maxLife: number;
+    alpha: number;
+    size: number;
+}
+/** Persistent ambient particles for Babylon.js scenes. */
+export declare class AmbientParticles {
+    private _opts;
+    private _particles;
+    private _t;
+    private _running;
+    constructor(_scene: BabylonScene, opts: AmbientParticleOptions);
+    start(): void;
+    stop(): void;
+    setWind(x: number, y?: number, z?: number): void;
+    update(dt: number): void;
+    private _spawn;
+    getParticles(): readonly Particle3D[];
+    destroy(): void;
+}
+export interface BackgroundSwayOptions {
+    windSensitivity?: number;
+    maxAngle?: number;
+    speed?: number;
+}
+/** Wind-responsive sway for Babylon.js meshes. */
+export declare class BackgroundSway {
+    private _target;
+    private _windSensitivity;
+    private _maxAngle;
+    private _speed;
+    private _windX;
+    private _t;
+    private _running;
+    constructor(target: BabylonMesh, opts?: BackgroundSwayOptions);
+    setWind(x: number, _y?: number, _z?: number): void;
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=ambient.d.ts.map

package/dist/ambient.d.ts.map

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

package/dist/ambient.js

@@ -0,0 +1,243 @@
+// ---------------------------------------------------------------------------
+//  @joydle/juice-babylon — Ambient life effects (Babylon.js)
+//
+//  Persistent background effects with start() / stop() / update(dt) / destroy().
+//  Call update(dt) each frame (dt in seconds).
+// ---------------------------------------------------------------------------
+/** Sine-wave scale pulse on a Babylon.js mesh. */
+export class IdleBreathing {
+    _target;
+    _amplitude;
+    _speed;
+    _phase;
+    _baseScale = { x: 1, y: 1, z: 1 };
+    _t = 0;
+    _running = false;
+    constructor(target, opts = {}) {
+        this._target = target;
+        this._amplitude = opts.amplitude ?? 0.02;
+        this._speed = opts.speed ?? 0.4;
+        this._phase = opts.phase ?? Math.random() * Math.PI * 2;
+    }
+    start() {
+        const s = this._target.scaling;
+        if (s)
+            this._baseScale = { x: s.x, y: s.y, z: s.z };
+        this._running = true;
+    }
+    stop() {
+        this._running = false;
+        const s = this._target.scaling;
+        if (s) {
+            s.x = this._baseScale.x;
+            s.y = this._baseScale.y;
+            s.z = this._baseScale.z;
+        }
+    }
+    update(dt) {
+        if (!this._running)
+            return;
+        this._t += dt;
+        const factor = 1 + Math.sin(this._t * this._speed * Math.PI * 2 + this._phase) * this._amplitude;
+        const s = this._target.scaling;
+        if (s) {
+            s.x = this._baseScale.x * factor;
+            s.y = this._baseScale.y * factor;
+            s.z = this._baseScale.z * factor;
+        }
+    }
+    destroy() { this.stop(); }
+}
+/** Gentle bob + rotation drift for Babylon.js meshes. */
+export class FloatingMotion {
+    _target;
+    _bobHeight;
+    _bobSpeed;
+    _rotationDrift;
+    _phase;
+    _baseY = 0;
+    _t = 0;
+    _running = false;
+    constructor(target, opts = {}) {
+        this._target = target;
+        this._bobHeight = opts.bobHeight ?? 0.1;
+        this._bobSpeed = opts.bobSpeed ?? 0.5;
+        this._rotationDrift = opts.rotationDrift ?? 0.03;
+        this._phase = opts.phase ?? Math.random() * Math.PI * 2;
+    }
+    start() {
+        this._baseY = this._target.position?.y ?? 0;
+        this._running = true;
+    }
+    stop() {
+        this._running = false;
+        const pos = this._target.position;
+        if (pos)
+            pos.y = this._baseY;
+    }
+    update(dt) {
+        if (!this._running)
+            return;
+        this._t += dt;
+        const angle = this._t * this._bobSpeed * Math.PI * 2 + this._phase;
+        const pos = this._target.position;
+        const rot = this._target.rotation;
+        if (pos)
+            pos.y = this._baseY + Math.sin(angle) * this._bobHeight;
+        if (rot)
+            rot.y += Math.sin(angle * 0.7) * this._rotationDrift * dt;
+    }
+    destroy() { this.stop(); }
+}
+/** Color temperature shift on Babylon.js mesh materials. */
+export class EnvironmentPulse {
+    _targets;
+    _cycleDuration;
+    _warmR;
+    _warmG;
+    _warmB;
+    _coolR;
+    _coolG;
+    _coolB;
+    _t = 0;
+    _running = false;
+    constructor(targets, opts = {}) {
+        this._targets = targets;
+        this._cycleDuration = opts.cycleDuration ?? 8;
+        const warm = opts.warmColor ?? 0xffcc88;
+        const cool = opts.coolColor ?? 0x88ccff;
+        this._warmR = ((warm >> 16) & 0xff) / 255;
+        this._warmG = ((warm >> 8) & 0xff) / 255;
+        this._warmB = (warm & 0xff) / 255;
+        this._coolR = ((cool >> 16) & 0xff) / 255;
+        this._coolG = ((cool >> 8) & 0xff) / 255;
+        this._coolB = (cool & 0xff) / 255;
+    }
+    start() { this._running = true; }
+    stop() { this._running = false; }
+    update(dt) {
+        if (!this._running)
+            return;
+        this._t += dt;
+        const mix = (Math.sin(this._t / this._cycleDuration * Math.PI * 2) + 1) * 0.5;
+        const r = this._warmR * mix + this._coolR * (1 - mix);
+        const g = this._warmG * mix + this._coolG * (1 - mix);
+        const b = this._warmB * mix + this._coolB * (1 - mix);
+        for (const t of this._targets) {
+            const mat = t.material;
+            if (mat?.diffuseColor) {
+                mat.diffuseColor.r = r;
+                mat.diffuseColor.g = g;
+                mat.diffuseColor.b = b;
+            }
+        }
+    }
+    destroy() { this.stop(); }
+}
+/** Persistent ambient particles for Babylon.js scenes. */
+export class AmbientParticles {
+    _opts;
+    _particles = [];
+    _t = 0;
+    _running = false;
+    constructor(_scene, opts) {
+        this._opts = {
+            type: opts.type,
+            density: opts.density ?? 30,
+            wind: opts.wind ?? { x: 0, y: 0, z: 0 },
+            color: opts.color ?? 0xffffff,
+            volume: opts.volume ?? 20,
+        };
+    }
+    start() {
+        this._running = true;
+        for (let i = 0; i < this._opts.density; i++)
+            this._particles.push(this._spawn(Math.random()));
+    }
+    stop() { this._running = false; this._particles = []; }
+    setWind(x, y = 0, z = 0) { this._opts.wind = { x, y, z }; }
+    update(dt) {
+        if (!this._running)
+            return;
+        this._t += dt;
+        const { type, wind, volume } = this._opts;
+        for (let i = this._particles.length - 1; i >= 0; i--) {
+            const p = this._particles[i];
+            p.life -= dt;
+            switch (type) {
+                case 'snow':
+                    p.vy -= 0.5 * dt;
+                    p.vx += wind.x * dt * 0.5;
+                    break;
+                case 'embers':
+                    p.vy += dt * 2;
+                    break;
+                case 'fireflies':
+                    p.vx += Math.sin(this._t * 2 + i) * dt * 0.5;
+                    p.vy += Math.cos(this._t * 1.5 + i) * dt * 0.3;
+                    break;
+                default:
+                    p.vx += wind.x * dt * 0.2;
+                    p.vy += wind.y * dt * 0.2;
+                    p.vz += wind.z * dt * 0.2;
+            }
+            p.x += p.vx * dt;
+            p.y += p.vy * dt;
+            p.z += p.vz * dt;
+            p.alpha = Math.max(0, Math.min(1, p.life / p.maxLife * 2, (p.maxLife - p.life) / p.maxLife * 4));
+            const half = volume / 2;
+            if (p.life <= 0 || Math.abs(p.x) > half || Math.abs(p.y) > half)
+                this._particles[i] = this._spawn(0);
+        }
+        while (this._particles.length < this._opts.density)
+            this._particles.push(this._spawn(Math.random()));
+    }
+    _spawn(lifeFraction) {
+        const v = this._opts.volume;
+        const maxLife = 5 + Math.random() * 5;
+        return {
+            x: (Math.random() - 0.5) * v, y: (Math.random() - 0.5) * v, z: (Math.random() - 0.5) * v,
+            vx: (Math.random() - 0.5) * 0.5, vy: (Math.random() - 0.5) * 0.5, vz: (Math.random() - 0.5) * 0.5,
+            life: maxLife * lifeFraction, maxLife, alpha: lifeFraction, size: 0.05 + Math.random() * 0.1,
+        };
+    }
+    getParticles() { return this._particles; }
+    destroy() { this.stop(); }
+}
+/** Wind-responsive sway for Babylon.js meshes. */
+export class BackgroundSway {
+    _target;
+    _windSensitivity;
+    _maxAngle;
+    _speed;
+    _windX = 0;
+    _t = 0;
+    _running = false;
+    constructor(target, opts = {}) {
+        this._target = target;
+        this._windSensitivity = opts.windSensitivity ?? 1;
+        this._maxAngle = opts.maxAngle ?? 0.15;
+        this._speed = opts.speed ?? 1;
+    }
+    setWind(x, _y = 0, _z = 0) { this._windX = x; }
+    start() { this._running = true; }
+    stop() {
+        this._running = false;
+        const rot = this._target.rotation;
+        if (rot)
+            rot.z = 0;
+    }
+    update(dt) {
+        if (!this._running)
+            return;
+        this._t += dt;
+        const strength = Math.abs(this._windX) * this._windSensitivity;
+        const target = Math.min(this._maxAngle, strength * 0.1) * Math.sign(this._windX || 1);
+        const sway = target + Math.sin(this._t * this._speed * 2.5) * target * 0.3;
+        const rot = this._target.rotation;
+        if (rot)
+            rot.z += (sway - rot.z) * Math.min(1, dt * 4);
+    }
+    destroy() { this.stop(); }
+}
+//# sourceMappingURL=ambient.js.map

package/dist/ambient.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,151 @@
+type BabylonColor3Like = {
+    r: number;
+    g: number;
+    b: number;
+};
+type BabylonMeshLike = {
+    material: {
+        diffuseColor?: BabylonColor3Like;
+        emissiveColor?: BabylonColor3Like;
+        alpha: number;
+    };
+};
+export interface PaletteShiftOptions {
+    /** Named palettes mapping to per-target diffuse RGB colors */
+    palettes?: Record<string, {
+        r: number;
+        g: number;
+        b: number;
+        alpha?: number;
+    }[]>;
+    /** Transition duration in seconds. Default: 0.3 */
+    duration?: number;
+}
+/** Lerp material.diffuseColor toward the named palette. */
+export declare class PaletteShift {
+    private _running;
+    private _targets;
+    private _palettes;
+    private _duration;
+    private _srcColors;
+    private _dstColors;
+    private _t;
+    private _transitioning;
+    constructor(targets: BabylonMeshLike[], opts?: PaletteShiftOptions);
+    setPalette(name: string): void;
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface GlowPulseOptions {
+    /** Min emissive brightness. Default: 0.0 */
+    minBrightness?: number;
+    /** Max emissive brightness. Default: 1.0 */
+    maxBrightness?: number;
+    /** Cycles per second. Default: 1.5 */
+    speed?: number;
+    /** Emissive base color (normalized 0-1). Default: white */
+    color?: BabylonColor3Like;
+}
+/** Pulse material.emissiveColor to suggest a glow. */
+export declare class GlowPulse {
+    private _t;
+    private _running;
+    private _target;
+    private _opts;
+    constructor(target: BabylonMeshLike, opts?: GlowPulseOptions);
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface SilhouetteFlashOptions {
+    /** Flash color (normalized 0-1). Default: white */
+    color?: BabylonColor3Like;
+    /** Flash duration in seconds. Default: 0.1 */
+    duration?: number;
+}
+/** Set material.diffuseColor to white then restore. */
+export declare class SilhouetteFlash {
+    private _flashing;
+    private _timer;
+    private _target;
+    private _opts;
+    private _origColor;
+    constructor(target: BabylonMeshLike, opts?: SilhouetteFlashOptions);
+    flash(): void;
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface RainbowCycleOptions {
+    /** Hue degrees per second. Default: 120 */
+    speed?: number;
+}
+/** Cycle through hue colors on material.diffuseColor. */
+export declare class RainbowCycle {
+    private _running;
+    private _hue;
+    private _target;
+    private _speed;
+    constructor(target: BabylonMeshLike, opts?: RainbowCycleOptions);
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface DarkenOptions {
+    /** Target alpha when darkened. Default: 0.3 */
+    targetAlpha?: number;
+    /** Transition duration in seconds. Default: 0.5 */
+    duration?: number;
+}
+/** Lower material.alpha on multiple meshes (game world darkening on pause). */
+export declare class DarkenOnPause {
+    private _running;
+    private _targets;
+    private _targetAlpha;
+    private _duration;
+    private _origAlpha;
+    private _t;
+    private _darkening;
+    private _restoring;
+    constructor(targets: BabylonMeshLike[], opts?: DarkenOptions);
+    darken(): void;
+    restore(): void;
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface SpotlightOptions {
+    /** Spotlight radius as fraction of screen (0-1). Default: 0.3 */
+    radius?: number;
+    /** Edge softness (0-1). Default: 0.2 */
+    softness?: number;
+    /** Overlay base color. Default: '#000000' */
+    color?: string;
+    /** Overlay opacity. Default: 0.85 */
+    opacity?: number;
+}
+/** Circular "spotlight" cutout using a radial-gradient mask on an HTML overlay element. */
+export declare class SpotlightReveal {
+    private _el;
+    private _opts;
+    private _cx;
+    private _cy;
+    private _visible;
+    constructor(overlayEl: HTMLElement, opts?: SpotlightOptions);
+    private _applyStyle;
+    setCenter(x: number, y: number): void;
+    show(): void;
+    hide(): void;
+    start(): void;
+    stop(): void;
+    update(_dt: number): void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAQA,KAAK,iBAAiB,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE;QACR,YAAY,CAAC,EAAE,iBAAiB,CAAC;QACjC,aAAa,CAAC,EAAE,iBAAiB,CAAC;QAClC,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAIF,MAAM,WAAW,mBAAmB;IAClC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC,CAAC;IACjF,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2DAA2D;AAC3D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,SAAS,CAAwE;IACzF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAA4D;IAC9E,OAAO,CAAC,UAAU,CAA4D;IAC9E,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,CAAC,EAAE,mBAAmB;IAMlE,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAe9B,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAEZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAkBxB,OAAO,IAAI,IAAI;CAChB;AAID,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4CAA4C;IAC5C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,sDAAsD;AACtD,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAA6B;gBAE9B,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,gBAAgB;IAU5D,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAEZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAaxB,OAAO,IAAI,IAAI;CAChB;AAID,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,uDAAuD;AACvD,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,UAAU,CAA2C;gBAEjD,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,sBAAsB;IAKlE,KAAK,IAAI,IAAI;IAYb,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IASZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAaxB,OAAO,IAAI,IAAI;CAQhB;AAID,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,mBAAmB;IAK/D,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IASZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAWxB,OAAO,IAAI,IAAI;CAChB;AAID,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+EAA+E;AAC/E,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAgB;IAClC,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,eAAe,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa;IAM5D,MAAM,IAAI,IAAI;IAOd,OAAO,IAAI,IAAI;IAMf,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAEZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAoBxB,OAAO,IAAI,IAAI;CAChB;AAID,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2FAA2F;AAC3F,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,GAAG,CAAO;IAClB,OAAO,CAAC,GAAG,CAAO;IAClB,OAAO,CAAC,QAAQ,CAAS;gBAEb,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE,gBAAgB;IAW3D,OAAO,CAAC,WAAW;IAWnB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAMrC,IAAI,IAAI,IAAI;IACZ,IAAI,IAAI,IAAI;IAEZ,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IACZ,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IACzB,OAAO,IAAI,IAAI;CAChB"}

package/dist/color.js

@@ -0,0 +1,283 @@
+// ---------------------------------------------------------------------------
+//  @joydle/juice-babylon — Color & Lighting effects
+//
+//  6 classes: PaletteShift, GlowPulse, SilhouetteFlash, RainbowCycle,
+//  DarkenOnPause, SpotlightReveal
+//  All share start() / stop() / update(dt) / destroy().
+// ---------------------------------------------------------------------------
+/** Lerp material.diffuseColor toward the named palette. */
+export class PaletteShift {
+    _running = false;
+    _targets;
+    _palettes;
+    _duration;
+    _srcColors = [];
+    _dstColors = [];
+    _t = 0;
+    _transitioning = false;
+    constructor(targets, opts) {
+        this._targets = targets;
+        this._palettes = opts?.palettes ?? {};
+        this._duration = opts?.duration ?? 0.3;
+    }
+    setPalette(name) {
+        const palette = this._palettes[name];
+        if (!palette)
+            return;
+        this._srcColors = this._targets.map(t => {
+            const c = t.material.diffuseColor ?? { r: 1, g: 1, b: 1 };
+            return { r: c.r, g: c.g, b: c.b, alpha: t.material.alpha };
+        });
+        this._dstColors = this._targets.map((_, i) => {
+            const e = palette[i] ?? palette[palette.length - 1];
+            return { r: e.r, g: e.g, b: e.b, alpha: e.alpha ?? 1 };
+        });
+        this._t = 0;
+        this._transitioning = true;
+    }
+    start() { this._running = true; }
+    stop() { this._running = false; this._transitioning = false; }
+    update(dt) {
+        if (!this._running || !this._transitioning)
+            return;
+        this._t += dt;
+        const p = Math.min(1, this._duration > 0 ? this._t / this._duration : 1);
+        for (let i = 0; i < this._targets.length; i++) {
+            const s = this._srcColors[i];
+            const d = this._dstColors[i];
+            if (!s || !d)
+                continue;
+            const mat = this._targets[i].material;
+            if (mat.diffuseColor) {
+                mat.diffuseColor.r = s.r + (d.r - s.r) * p;
+                mat.diffuseColor.g = s.g + (d.g - s.g) * p;
+                mat.diffuseColor.b = s.b + (d.b - s.b) * p;
+            }
+            mat.alpha = s.alpha + (d.alpha - s.alpha) * p;
+        }
+        if (p >= 1)
+            this._transitioning = false;
+    }
+    destroy() { this.stop(); }
+}
+/** Pulse material.emissiveColor to suggest a glow. */
+export class GlowPulse {
+    _t = 0;
+    _running = false;
+    _target;
+    _opts;
+    constructor(target, opts) {
+        this._target = target;
+        this._opts = {
+            minBrightness: opts?.minBrightness ?? 0.0,
+            maxBrightness: opts?.maxBrightness ?? 1.0,
+            speed: opts?.speed ?? 1.5,
+            color: opts?.color ?? { r: 1, g: 1, b: 1 },
+        };
+    }
+    start() { this._running = true; }
+    stop() { this._running = false; }
+    update(dt) {
+        if (!this._running)
+            return;
+        this._t += dt;
+        const { minBrightness, maxBrightness, speed, color } = this._opts;
+        const bright = minBrightness + (maxBrightness - minBrightness) * (0.5 + 0.5 * Math.sin(this._t * speed * Math.PI * 2));
+        const em = this._target.material.emissiveColor;
+        if (em) {
+            em.r = color.r * bright;
+            em.g = color.g * bright;
+            em.b = color.b * bright;
+        }
+    }
+    destroy() { this.stop(); }
+}
+/** Set material.diffuseColor to white then restore. */
+export class SilhouetteFlash {
+    _flashing = false;
+    _timer = 0;
+    _target;
+    _opts;
+    _origColor = { r: 1, g: 1, b: 1 };
+    constructor(target, opts) {
+        this._target = target;
+        this._opts = { color: { r: 1, g: 1, b: 1 }, duration: 0.1, ...opts };
+    }
+    flash() {
+        const c = this._target.material.diffuseColor ?? { r: 1, g: 1, b: 1 };
+        this._origColor = { r: c.r, g: c.g, b: c.b };
+        if (this._target.material.diffuseColor) {
+            this._target.material.diffuseColor.r = this._opts.color.r;
+            this._target.material.diffuseColor.g = this._opts.color.g;
+            this._target.material.diffuseColor.b = this._opts.color.b;
+        }
+        this._flashing = true;
+        this._timer = 0;
+    }
+    start() { }
+    stop() {
+        if (this._flashing && this._target.material.diffuseColor) {
+            this._target.material.diffuseColor.r = this._origColor.r;
+            this._target.material.diffuseColor.g = this._origColor.g;
+            this._target.material.diffuseColor.b = this._origColor.b;
+            this._flashing = false;
+        }
+    }
+    update(dt) {
+        if (!this._flashing)
+            return;
+        this._timer += dt;
+        if (this._timer >= this._opts.duration) {
+            if (this._target.material.diffuseColor) {
+                this._target.material.diffuseColor.r = this._origColor.r;
+                this._target.material.diffuseColor.g = this._origColor.g;
+                this._target.material.diffuseColor.b = this._origColor.b;
+            }
+            this._flashing = false;
+        }
+    }
+    destroy() {
+        this.stop();
+        if (this._flashing && this._target.material.diffuseColor) {
+            this._target.material.diffuseColor.r = this._origColor.r;
+            this._target.material.diffuseColor.g = this._origColor.g;
+            this._target.material.diffuseColor.b = this._origColor.b;
+        }
+    }
+}
+/** Cycle through hue colors on material.diffuseColor. */
+export class RainbowCycle {
+    _running = false;
+    _hue = 0;
+    _target;
+    _speed;
+    constructor(target, opts) {
+        this._target = target;
+        this._speed = opts?.speed ?? 120;
+    }
+    start() { this._running = true; }
+    stop() {
+        this._running = false;
+        if (this._target.material.diffuseColor) {
+            this._target.material.diffuseColor.r = 1;
+            this._target.material.diffuseColor.g = 1;
+            this._target.material.diffuseColor.b = 1;
+        }
+    }
+    update(dt) {
+        if (!this._running)
+            return;
+        this._hue = (this._hue + this._speed * dt) % 360;
+        const [r, g, b] = _hslToRgb(this._hue / 360, 1, 0.5);
+        if (this._target.material.diffuseColor) {
+            this._target.material.diffuseColor.r = r;
+            this._target.material.diffuseColor.g = g;
+            this._target.material.diffuseColor.b = b;
+        }
+    }
+    destroy() { this.stop(); }
+}
+/** Lower material.alpha on multiple meshes (game world darkening on pause). */
+export class DarkenOnPause {
+    _running = false;
+    _targets;
+    _targetAlpha;
+    _duration;
+    _origAlpha = [];
+    _t = 0;
+    _darkening = false;
+    _restoring = false;
+    constructor(targets, opts) {
+        this._targets = targets;
+        this._targetAlpha = opts?.targetAlpha ?? 0.3;
+        this._duration = opts?.duration ?? 0.5;
+    }
+    darken() {
+        this._origAlpha = this._targets.map(t => t.material.alpha);
+        this._t = 0;
+        this._darkening = true;
+        this._restoring = false;
+    }
+    restore() {
+        this._t = 0;
+        this._restoring = true;
+        this._darkening = false;
+    }
+    start() { this._running = true; }
+    stop() { this._running = false; this._darkening = false; this._restoring = false; }
+    update(dt) {
+        if (!this._running)
+            return;
+        if (!this._darkening && !this._restoring)
+            return;
+        this._t += dt;
+        const p = Math.min(1, this._duration > 0 ? this._t / this._duration : 1);
+        if (this._darkening) {
+            for (let i = 0; i < this._targets.length; i++) {
+                const orig = this._origAlpha[i] ?? 1;
+                this._targets[i].material.alpha = orig + (this._targetAlpha - orig) * p;
+            }
+            if (p >= 1)
+                this._darkening = false;
+        }
+        else if (this._restoring) {
+            for (let i = 0; i < this._targets.length; i++) {
+                const orig = this._origAlpha[i] ?? 1;
+                this._targets[i].material.alpha = this._targetAlpha + (orig - this._targetAlpha) * p;
+            }
+            if (p >= 1)
+                this._restoring = false;
+        }
+    }
+    destroy() { this.stop(); }
+}
+/** Circular "spotlight" cutout using a radial-gradient mask on an HTML overlay element. */
+export class SpotlightReveal {
+    _el;
+    _opts;
+    _cx = 0.5;
+    _cy = 0.5;
+    _visible = false;
+    constructor(overlayEl, opts) {
+        this._el = overlayEl;
+        this._opts = {
+            radius: opts?.radius ?? 0.3,
+            softness: opts?.softness ?? 0.2,
+            color: opts?.color ?? '#000000',
+            opacity: opts?.opacity ?? 0.85,
+        };
+        this._applyStyle();
+    }
+    _applyStyle() {
+        const { radius, softness, color, opacity } = this._opts;
+        const inner = Math.max(0, radius - softness * 0.5);
+        const outer = radius + softness * 0.5;
+        this._el.style.background = `radial-gradient(circle at ${this._cx * 100}% ${this._cy * 100}%, transparent ${inner * 100}%, ${color} ${outer * 100}%)`;
+        this._el.style.opacity = String(opacity);
+        this._el.style.pointerEvents = 'none';
+        this._el.style.position = 'absolute';
+        this._el.style.inset = '0';
+    }
+    setCenter(x, y) {
+        this._cx = Math.max(0, Math.min(1, x));
+        this._cy = Math.max(0, Math.min(1, y));
+        if (this._visible)
+            this._applyStyle();
+    }
+    show() { this._visible = true; this._el.style.display = 'block'; this._applyStyle(); }
+    hide() { this._visible = false; this._el.style.display = 'none'; }
+    start() { }
+    stop() { }
+    update(_dt) { }
+    destroy() { this.hide(); }
+}
+// ---- Helpers ---------------------------------------------------------------
+function _hslToRgb(h, s, l) {
+    const a = s * Math.min(l, 1 - l);
+    const f = (n) => {
+        const k = (n + h * 12) % 12;
+        return l - a * Math.max(Math.min(k - 3, 9 - k, 1), -1);
+    };
+    return [f(0), f(8), f(4)];
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/dist/gamefeel.d.ts

@@ -0,0 +1,90 @@
+type Vec3Like = {
+    x: number;
+    y: number;
+    z: number;
+};
+type BabylonObjectLike = {
+    position: Vec3Like;
+    scaling: Vec3Like;
+};
+export interface GhostTrailOptions {
+    /** Number of ghost copies in history. Default: 5 */
+    count?: number;
+    /** Position lag frames between ghosts. Default: 3 */
+    spacing?: number;
+    /** Starting opacity of the most recent ghost. Default: 0.5 */
+    fadeStart?: number;
+    /** Tint color (-1 = same as original). Default: -1 */
+    color?: number;
+}
+/**
+ * Afterimage trail — stores position history each frame.
+ * Use `getHistory()` to drive clone meshes for custom rendering.
+ */
+export declare class GhostTrail {
+    private _running;
+    private _history;
+    private _opts;
+    private _target;
+    constructor(target: BabylonObjectLike, opts?: GhostTrailOptions);
+    start(): void;
+    stop(): void;
+    update(_dt: number): void;
+    /** Returns sampled ghost positions + alpha. Index 0 is newest. */
+    getHistory(): Array<{
+        x: number;
+        y: number;
+        z: number;
+        alpha: number;
+    }>;
+    destroy(): void;
+}
+export interface LandSquashOptions {
+    /** Horizontal (X/Z) scaling multiplier on squash. Default: 1.3 */
+    squashX?: number;
+    /** Vertical (Y) scaling multiplier on squash. Default: 0.7 */
+    squashY?: number;
+    /** Seconds to spring back to original scale. Default: 0.25 */
+    duration?: number;
+}
+/** Squash-stretch on landing using mesh scaling. */
+export declare class LandSquash {
+    private _active;
+    private _t;
+    private _target;
+    private _opts;
+    private _base;
+    constructor(target: BabylonObjectLike, opts?: LandSquashOptions);
+    trigger(): void;
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export interface XPMagnetOptions {
+    /** Base speed in world units per second. Default: 200 */
+    speed?: number;
+    /** Speed multiplier per second of travel. Default: 2.0 */
+    acceleration?: number;
+    /** Snap distance in world units. Default: 0.1 */
+    snapDistance?: number;
+    /** Called when the object reaches the target. */
+    onComplete?: () => void;
+}
+/** Fly toward a 3D target point with increasing speed. */
+export declare class XPMagnet {
+    private _running;
+    private _active;
+    private _target;
+    private _opts;
+    private _goal;
+    private _currentSpeed;
+    constructor(target: BabylonObjectLike, opts?: XPMagnetOptions);
+    flyTo(goalX: number, goalY: number, goalZ?: number): void;
+    start(): void;
+    stop(): void;
+    update(dt: number): void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=gamefeel.d.ts.map

package/dist/gamefeel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gamefeel.d.ts","sourceRoot":"","sources":["../src/gamefeel.ts"],"names":[],"mappings":"AAOA,KAAK,QAAQ,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACpD,KAAK,iBAAiB,GAAG;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;AAIF,MAAM,WAAW,iBAAiB;IAChC,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAkD;IAClE,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,OAAO,CAAoB;gBAEvB,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,iBAAiB;IAU/D,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAEZ,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQzB,kEAAkE;IAClE,UAAU,IAAI,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAYvE,OAAO,IAAI,IAAI;CAChB;AAID,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,EAAE,CAAK;IACf,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,KAAK,CAAwB;gBAEzB,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,iBAAiB;IAS/D,OAAO,IAAI,IAAI;IAUf,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAEZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAkBxB,OAAO,IAAI,IAAI;CAChB;AAID,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,0DAA0D;AAC1D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,KAAK,CAA8E;IAC3F,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,eAAe;IAU7D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAMpD,KAAK,IAAI,IAAI;IACb,IAAI,IAAI,IAAI;IAEZ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAsBxB,OAAO,IAAI,IAAI;CAChB"}

package/dist/gamefeel.js

@@ -0,0 +1,156 @@
+// ---------------------------------------------------------------------------
+//  @joydle/juice-babylon — Game-feel extras
+//
+//  GhostTrail, LandSquash, XPMagnet
+//  All share start() / stop() / update(dt) / destroy().
+// ---------------------------------------------------------------------------
+/**
+ * Afterimage trail — stores position history each frame.
+ * Use `getHistory()` to drive clone meshes for custom rendering.
+ */
+export class GhostTrail {
+    _running = false;
+    _history = [];
+    _opts;
+    _target;
+    constructor(target, opts) {
+        this._target = target;
+        this._opts = {
+            count: opts?.count ?? 5,
+            spacing: opts?.spacing ?? 3,
+            fadeStart: opts?.fadeStart ?? 0.5,
+            color: opts?.color ?? -1,
+        };
+    }
+    start() { this._running = true; this._history = []; }
+    stop() { this._running = false; this._history = []; }
+    update(_dt) {
+        if (!this._running)
+            return;
+        const p = this._target.position;
+        this._history.unshift({ x: p.x, y: p.y, z: p.z });
+        const maxLen = this._opts.count * this._opts.spacing;
+        if (this._history.length > maxLen)
+            this._history.length = maxLen;
+    }
+    /** Returns sampled ghost positions + alpha. Index 0 is newest. */
+    getHistory() {
+        const { count, spacing, fadeStart } = this._opts;
+        const result = [];
+        for (let i = 0; i < count; i++) {
+            const idx = i * spacing;
+            const entry = this._history[idx];
+            if (!entry)
+                break;
+            result.push({ ...entry, alpha: fadeStart * (1 - i / count) });
+        }
+        return result;
+    }
+    destroy() { this.stop(); }
+}
+/** Squash-stretch on landing using mesh scaling. */
+export class LandSquash {
+    _active = false;
+    _t = 0;
+    _target;
+    _opts;
+    _base = { x: 1, y: 1, z: 1 };
+    constructor(target, opts) {
+        this._target = target;
+        this._opts = {
+            squashX: opts?.squashX ?? 1.3,
+            squashY: opts?.squashY ?? 0.7,
+            duration: opts?.duration ?? 0.25,
+        };
+    }
+    trigger() {
+        const sc = this._target.scaling;
+        this._base = { x: sc.x, y: sc.y, z: sc.z };
+        sc.x = this._base.x * this._opts.squashX;
+        sc.y = this._base.y * this._opts.squashY;
+        sc.z = this._base.z * this._opts.squashX;
+        this._t = 0;
+        this._active = true;
+    }
+    start() { }
+    stop() { this._active = false; }
+    update(dt) {
+        if (!this._active)
+            return;
+        this._t += dt;
+        const p = Math.min(1, this._opts.duration > 0 ? this._t / this._opts.duration : 1);
+        const spring = _springOut(p);
+        const tx = this._base.x * this._opts.squashX;
+        const ty = this._base.y * this._opts.squashY;
+        const tz = this._base.z * this._opts.squashX;
+        const sc = this._target.scaling;
+        sc.x = tx + (this._base.x - tx) * spring;
+        sc.y = ty + (this._base.y - ty) * spring;
+        sc.z = tz + (this._base.z - tz) * spring;
+        if (p >= 1) {
+            sc.x = this._base.x;
+            sc.y = this._base.y;
+            sc.z = this._base.z;
+            this._active = false;
+        }
+    }
+    destroy() { this.stop(); }
+}
+/** Fly toward a 3D target point with increasing speed. */
+export class XPMagnet {
+    _running = false;
+    _active = false;
+    _target;
+    _opts;
+    _goal = { x: 0, y: 0, z: 0 };
+    _currentSpeed = 0;
+    constructor(target, opts) {
+        this._target = target;
+        this._opts = {
+            speed: opts?.speed ?? 200,
+            acceleration: opts?.acceleration ?? 2.0,
+            snapDistance: opts?.snapDistance ?? 0.1,
+            onComplete: opts?.onComplete,
+        };
+    }
+    flyTo(goalX, goalY, goalZ = 0) {
+        this._goal = { x: goalX, y: goalY, z: goalZ };
+        this._currentSpeed = this._opts.speed;
+        this._active = true;
+    }
+    start() { this._running = true; }
+    stop() { this._running = false; this._active = false; }
+    update(dt) {
+        if (!this._running || !this._active)
+            return;
+        const pos = this._target.position;
+        const dx = this._goal.x - pos.x;
+        const dy = this._goal.y - pos.y;
+        const dz = this._goal.z - pos.z;
+        const dist = Math.sqrt(dx * dx + dy * dy + dz * dz);
+        if (dist <= this._opts.snapDistance) {
+            pos.x = this._goal.x;
+            pos.y = this._goal.y;
+            pos.z = this._goal.z;
+            this._active = false;
+            this._opts.onComplete?.();
+            return;
+        }
+        this._currentSpeed *= 1 + this._opts.acceleration * dt;
+        const move = Math.min(this._currentSpeed * dt, dist);
+        pos.x += (dx / dist) * move;
+        pos.y += (dy / dist) * move;
+        pos.z += (dz / dist) * move;
+    }
+    destroy() { this.stop(); }
+}
+// ---- Helpers ---------------------------------------------------------------
+function _springOut(t) {
+    const c4 = (2 * Math.PI) / 3;
+    if (t === 0)
+        return 0;
+    if (t === 1)
+        return 1;
+    return Math.pow(2, -10 * t) * Math.sin((t * 10 - 0.75) * c4) + 1;
+}
+//# sourceMappingURL=gamefeel.js.map

package/dist/gamefeel.js.map

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

package/dist/index.d.ts

@@ -10,4 +10,10 @@ export { addMeshHelpers } from './MeshHelpers.js';
 export type { JuicedMesh, SquashOptions, ExplodeOutOptions, BobOptions, SpinOptions, } from './MeshHelpers.js';
 export { createBabylonJuiceToolkit } from './toolkit.js';
 export type { CreateToolkitOptions } from './toolkit.js';
+export { IdleBreathing, FloatingMotion, EnvironmentPulse, AmbientParticles, BackgroundSway, } from './ambient.js';
+export type { IdleBreathingOptions, FloatingMotionOptions, EnvironmentPulseOptions, AmbientParticleOptions, BackgroundSwayOptions, } from './ambient.js';
+export { PaletteShift, GlowPulse, SilhouetteFlash, RainbowCycle, DarkenOnPause, SpotlightReveal, } from './color.js';
+export type { PaletteShiftOptions, GlowPulseOptions, SilhouetteFlashOptions, RainbowCycleOptions, DarkenOptions, SpotlightOptions, } from './color.js';
+export { GhostTrail, LandSquash, XPMagnet } from './gamefeel.js';
+export type { GhostTrailOptions, LandSquashOptions, XPMagnetOptions } from './gamefeel.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,yBAAyB,EACzB,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,YAAY,EACV,WAAW,EACX,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,yBAAyB,EACzB,QAAQ,EACR,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG7E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD,OAAO,EACL,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,GAClF,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,oBAAoB,EAAE,qBAAqB,EAAE,uBAAuB,EACpE,sBAAsB,EAAE,qBAAqB,GAC9C,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,GACvF,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,mBAAmB,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,mBAAmB,EAClF,aAAa,EAAE,gBAAgB,GAChC,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -15,4 +15,10 @@ export { TrailEffect } from './TrailMesh.js';
 export { addMeshHelpers } from './MeshHelpers.js';
 // Toolkit factory
 export { createBabylonJuiceToolkit } from './toolkit.js';
+// Ambient life effects
+export { IdleBreathing, FloatingMotion, EnvironmentPulse, AmbientParticles, BackgroundSway, } from './ambient.js';
+// Color & Lighting
+export { PaletteShift, GlowPulse, SilhouetteFlash, RainbowCycle, DarkenOnPause, SpotlightReveal, } from './color.js';
+// Game-feel extras
+export { GhostTrail, LandSquash, XPMagnet } from './gamefeel.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,uBAAuB;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAgBtC,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASlD,kBAAkB;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,uBAAuB;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAgBtC,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,aAAa;AACb,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,eAAe;AACf,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AASlD,kBAAkB;AAClB,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGzD,uBAAuB;AACvB,OAAO,EACL,aAAa,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,cAAc,GAClF,MAAM,cAAc,CAAC;AAMtB,mBAAmB;AACnB,OAAO,EACL,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,GACvF,MAAM,YAAY,CAAC;AAMpB,mBAAmB;AACnB,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joydle/juice-babylon",
-  "version": "0.1.4",
+  "version": "0.1.19",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",