emeraldengine 2.2.0 → 3.0.0

package/dist/types/{particlesystem → src/particlesystem}/ParticleSettings.d.ts

@@ -1,18 +1,4 @@
-import { Vector2 } from "../Physics";
-interface ParticleSettingsConfig {
-    lifetime?: number;
-    velocity?: Vector2;
-    gravity?: Vector2;
-    amount?: number;
-    direction?: Vector2;
-    spread?: number;
-    emissionRate?: number;
-    frame?: number;
-    offset?: number;
-    rotation?: number;
-    scale?: Vector2;
-    animation?: any;
-}
+export default ParticleSettings;
 /**
  * @class ParticleSettings
  * @description Represents the settings for a particle system
@@ -30,6 +16,23 @@ interface ParticleSettingsConfig {
  * @param {Array} animation - The animation of the particle
  */
 declare class ParticleSettings {
+    constructor({ lifetime, velocity, gravity, amount, direction, spread, emissionRate, frame, offset, rotation, scale, animation, shape, shapeRadius, shapeSize, scaleOverLife, alphaOverLife, colorOverLife, rotationSpeed, drag, }?: {
+        lifetime?: number;
+        velocity?: Vector2;
+        gravity?: Vector2;
+        amount?: number;
+        direction?: Vector2;
+        spread?: number;
+        emissionRate?: number;
+        shape?: string;
+        shapeRadius?: number;
+        shapeSize?: Vector2;
+        scaleOverLife?: any;
+        alphaOverLife?: any;
+        colorOverLife?: any;
+        rotationSpeed?: number;
+        drag?: number;
+    });
     lifetime: number;
     velocity: Vector2;
     gravity: Vector2;
@@ -37,13 +40,18 @@ declare class ParticleSettings {
     direction: Vector2;
     spread: number;
     emissionRate: number;
-    frame?: number;
-    offset?: number;
-    rotation?: number;
-    scale?: Vector2;
-    animation?: any;
-    constructor({ lifetime, velocity, gravity, amount, direction, spread, emissionRate, // particles per second
-    frame, offset, rotation, scale, animation }?: ParticleSettingsConfig);
+    frame: any;
+    offset: any;
+    rotation: any;
+    scale: any;
+    animation: any;
+    shape: string;
+    shapeRadius: number;
+    shapeSize: Vector2;
+    scaleOverLife: any;
+    alphaOverLife: any;
+    colorOverLife: any;
+    rotationSpeed: number;
+    drag: number;
 }
-export default ParticleSettings;
-//# sourceMappingURL=ParticleSettings.d.ts.map
+import { Vector2 } from "../Physics.js";

package/dist/types/{particlesystem → src/particlesystem}/Particles.d.ts

@@ -1,8 +1,3 @@
-import GameObject from "../components/GameObject";
-import InstancedTexture from "../InstancedTexture";
-import { Vector2, Vector3 } from "../Physics";
-import Particle from "./Particle";
-import ParticleSettings from "./ParticleSettings";
 /**
  * @class Particles
  * @description Represents a particle system
@@ -16,13 +11,14 @@ import ParticleSettings from "./ParticleSettings";
  * @param {ParticleSettings} settings - The settings for the particle system
  */
 export default class Particles {
+    constructor(name: any, texturePath: any, frameWidth: any, frameHeight: any, framesPerRow: any, totalFrames: any, duration?: number, settings?: any);
     settings: ParticleSettings;
     position: Vector3;
-    rotation: number;
-    scale: Vector2;
-    particles: Particle[];
+    rotation: any;
+    scale: any;
+    particles: any[];
     duration: number;
-    offset: number;
+    offset: any;
     elapsed: number;
     active: boolean;
     instanceCount: number;
@@ -31,14 +27,15 @@ export default class Particles {
     stopped: boolean;
     gameObject: GameObject;
     instancedTexture: InstancedTexture;
-    lastEmitPosition: Vector3;
-    constructor(name: string, texturePath: string, frameWidth: number, frameHeight: number, framesPerRow: number, totalFrames: number, duration?: number, settings?: ParticleSettings | null);
+    /** @private */
+    private _pool;
     /**
      * @method play
      * @description Plays the particle system
      * @param {Vector3} newPosition - The position to play the particle system at
      */
     play(newPosition: Vector3): void;
+    lastEmitPosition: Vector3;
     /**
      * @method emitParticles
      * @description Emits particles
@@ -46,6 +43,14 @@ export default class Particles {
      * @param {Vector3} position - The position to emit the particles at
      */
     emitParticles(count: number, position: Vector3): void;
+    /**
+     * @method _spawnOffset
+     * @description Returns a spawn offset { x, y } from the emitter center based on
+     * the configured emitter shape.
+     * @param {number} finalAngle - The chosen emission angle (for the cone shape)
+     * @private
+     */
+    private _spawnOffset;
     /**
      * @method update
      * @description Updates the particle system
@@ -68,4 +73,7 @@ export default class Particles {
      */
     reset(): void;
 }
-//# sourceMappingURL=Particles.d.ts.map
+import ParticleSettings from "./ParticleSettings.js";
+import { Vector3 } from "../Physics.js";
+import GameObject from "../components/GameObject.js";
+import InstancedTexture from "../InstancedTexture.js";

package/index.js

@@ -9,9 +9,40 @@ import { Physics, Vector2, Vector3 } from "./src/Physics.js";
 import Scene from "./src/Scene.js";
 import { Square2D, Triangle2D, Circle2D } from "./src/Shapes.js";
 import Storage from "./src/Storage.js";
+import EmeraldDB from "./src/EmeraldDB.js";
 import Texture from "./src/Texture.js";
 import Time from "./src/Time.js";
 import Transform from "./src/Transform.js";
+import MathUtils from "./src/MathUtils.js";
+import Pool from "./src/Pool.js";
+import Animator from "./src/Animator.js";
+import Tilemap from "./src/Tilemap.js";
+import CameraController from "./src/CameraController.js";
+import Camera from "./src/Camera.js";
+import Easing from "./src/Easing.js";
+import Tween from "./src/Tween.js";
+import Timer from "./src/Timer.js";
+import StateMachine from "./src/StateMachine.js";
+import SpatialGrid from "./src/SpatialGrid.js";
+import TextureAtlas from "./src/TextureAtlas.js";
+import CanvasText from "./src/CanvasText.js";
+import DebugOverlay from "./src/DebugOverlay.js";
+import Serializer from "./src/Serializer.js";
+import Coroutine from "./src/Coroutine.js";
+import Interpolator from "./src/Interpolator.js";
+import ScreenEffects from "./src/ScreenEffects.js";
+import SpriteBatch from "./src/SpriteBatch.js";
+import ParticleEmitter from "./src/ParticleEmitter.js";
+import CollisionLayers from "./src/CollisionLayers.js";
+import TiledMap from "./src/importers/TiledMap.js";
+import Aseprite from "./src/importers/Aseprite.js";
+import RenderTarget from "./src/RenderTarget.js";
+import RenderStats from "./src/managers/RenderStats.js";
+import PostProcessor, { PostEffect } from "./src/PostProcessor.js";
+import PostEffects, { BloomEffect } from "./src/PostEffects.js";
+import Material from "./src/Material.js";
+import UI from "./src/UI.js";
+import InputManager from "./src/managers/InputManager.js";
 import Particle from "./src/particlesystem/Particle.js";
 import Particles from "./src/particlesystem/Particles.js";
 import ParticleSettings from "./src/particlesystem/ParticleSettings.js";
@@ -19,6 +50,9 @@ import AudioManager from "./src/managers/AudioManager.js";
 import CameraManager from "./src/managers/CameraManager.js";
 import EventManager from "./src/managers/EventManager.js";
 import SceneManager from "./src/managers/SceneManager.js";
+import TextureManager from "./src/managers/TextureManager.js";
+import AssetManager from "./src/managers/AssetManager.js";
+import NetworkManager from "./src/managers/NetworkManager.js";
 import DirectionalLight from "./src/lights/DirectionalLight.js";
 import PointLight from "./src/lights/PointLight.js";
 import BoxCollider from "./src/components/BoxCollider.js";
@@ -28,6 +62,7 @@ import CircleColliderDebug from "./src/components/CircleColliderDebug.js";
 import Collider from "./src/components/Collider.js";
 import GameObject from "./src/components/GameObject.js";
 import RigidBody from "./src/components/RigidBody.js";
+import Behaviour from "./src/components/Behaviour.js";
 
 export {
   Emerald,
@@ -45,9 +80,42 @@ export {
   Triangle2D,
   Circle2D,
   Storage,
+  EmeraldDB,
   Texture,
   Time,
   Transform,
+  MathUtils,
+  Pool,
+  Animator,
+  Tilemap,
+  CameraController,
+  Camera,
+  Easing,
+  Tween,
+  Timer,
+  StateMachine,
+  SpatialGrid,
+  TextureAtlas,
+  CanvasText,
+  DebugOverlay,
+  Serializer,
+  Coroutine,
+  Interpolator,
+  ScreenEffects,
+  SpriteBatch,
+  ParticleEmitter,
+  CollisionLayers,
+  TiledMap,
+  Aseprite,
+  RenderTarget,
+  RenderStats,
+  PostProcessor,
+  PostEffect,
+  PostEffects,
+  BloomEffect,
+  Material,
+  UI,
+  InputManager,
   Particle,
   Particles,
   ParticleSettings,
@@ -55,6 +123,9 @@ export {
   CameraManager,
   EventManager,
   SceneManager,
+  TextureManager,
+  AssetManager,
+  NetworkManager,
   DirectionalLight,
   PointLight,
   BoxCollider,
@@ -64,4 +135,5 @@ export {
   Collider,
   GameObject,
   RigidBody,
+  Behaviour,
 };

package/package.json

@@ -1,62 +1,76 @@
 {
-    "name": "emeraldengine",
-    "version": "2.2.0",
-    "description": "2D graphics library for Web",
-    "type": "module",
-    "main": "index.js",
-    "module": "index.js",
-    "types": "dist/types/index.d.ts",
-    "exports": {
-        ".": {
-            "types": "./dist/types/index.d.ts",
-            "import": "./index.js",
-            "default": "./index.js"
-        }
-    },
-    "files": [
-        "index.js",
-        "src",
-        "dist/types"
-    ],
-    "sideEffects": false,
-    "engines": {
-        "node": ">=12.0.0"
-    },
-    "keywords": [
-        "2D",
-        "graphics",
-        "game",
-        "engine",
-        "webgl",
-        "webgl2",
-        "canvas",
-        "gamedev",
-        "rendering",
-        "sprite",
-        "particle-system",
-        "physics"
-    ],
-    "dependencies": {
-        "gl-matrix": "^3.4.3",
-        "planck": "^1.4.2"
-    },
-    "peerDependencies": {
-        "colyseus.js": "^0.16.16"
-    },
-    "peerDependenciesMeta": {
-        "colyseus.js": {
-            "optional": true
-        }
-    },
-    "author": "vahan-gev",
-    "license": "MIT",
-    "homepage": "https://github.com/vahan-gev/emeraldengine#readme",
-    "bugs": {
-        "url": "https://github.com/vahan-gev/emeraldengine/issues"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/vahan-gev/emeraldengine.git"
-    },
-    "devDependencies": {}
+  "name": "emeraldengine",
+  "version": "3.0.0",
+  "description": "2D graphics library for Web",
+  "type": "module",
+  "main": "index.js",
+  "module": "index.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "src",
+    "dist/types"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=12.0.0"
+  },
+  "keywords": [
+    "2D",
+    "graphics",
+    "game",
+    "engine",
+    "webgl",
+    "webgl2",
+    "canvas",
+    "gamedev",
+    "rendering",
+    "sprite",
+    "particle-system",
+    "physics"
+  ],
+  "dependencies": {
+    "gl-matrix": "^3.4.3",
+    "planck": "^1.4.2"
+  },
+  "peerDependencies": {
+    "colyseus.js": "^0.16.16"
+  },
+  "peerDependenciesMeta": {
+    "colyseus.js": {
+      "optional": true
+    }
+  },
+  "author": "vahan-gev",
+  "license": "MIT",
+  "homepage": "https://github.com/vahan-gev/emeraldengine#readme",
+  "bugs": {
+    "url": "https://github.com/vahan-gev/emeraldengine/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vahan-gev/emeraldengine.git"
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs",
+    "types": "tsc -p tsconfig.json",
+    "prepublishOnly": "npm run types && npm test",
+    "format": "prettier --write \"src/**/*.js\" \"test/**/*.mjs\" index.js",
+    "format:check": "prettier --check \"src/**/*.js\" index.js"
+  },
+  "devDependencies": {
+    "@colyseus/schema": "^3.0.76",
+    "colyseus": "^0.16.5",
+    "colyseus.js": "^0.16.22",
+    "prettier": "^3.3.0",
+    "typescript": "^5.9.3",
+    "vite": "^5.4.0"
+  }
 }

package/src/Animator.js

@@ -0,0 +1,95 @@
+import Behaviour from "./components/Behaviour.js";
+import Drawable from "./Drawable.js";
+
+/**
+ * @class Animator
+ * @description A component that manages named animation clips for a Texture (or
+ * any Drawable) on the same GameObject. Register clips once, then switch between
+ * them by name — handy for character states like idle/run/jump.
+ *
+ * @example
+ * const anim = new Animator();
+ * anim.addClip("idle", [0, 1, 2, 3], { speed: 150 });
+ * anim.addClip("jump", [8, 9], { speed: 100, loop: false });
+ * obj.addComponent(texture);
+ * obj.addComponent(anim);
+ * anim.play("idle");
+ */
+class Animator extends Behaviour {
+  constructor() {
+    super();
+    this.clips = new Map();
+    this.current = null;
+    this.drawable = null;
+  }
+
+  /**
+   * @method addClip
+   * @description Registers a named clip.
+   * @param {string} name - The clip name
+   * @param {number[]} frames - Frame indices to play
+   * @param {Object} [options] - { speed = 100, loop = true }
+   * @returns {Animator} - this
+   */
+  addClip(name, frames, options = {}) {
+    const { speed = 100, loop = true } = options;
+    this.clips.set(name, { frames, speed, loop });
+    return this;
+  }
+
+  start() {
+    this._resolveDrawable();
+  }
+
+  /** @private */
+  _resolveDrawable() {
+    if (!this.drawable && this.gameObject && this.gameObject.getComponent) {
+      this.drawable = this.gameObject.getComponent(Drawable);
+    }
+    return this.drawable;
+  }
+
+  /**
+   * @method play
+   * @description Plays a registered clip. No-op if it's already current.
+   * @param {string} name - The clip name
+   * @returns {Animator} - this
+   */
+  play(name) {
+    if (this.current === name) return this;
+    const clip = this.clips.get(name);
+    const drawable = this._resolveDrawable();
+    if (!clip || !drawable) return this;
+
+    this.current = name;
+    if (clip.loop) {
+      drawable.playAnimation(clip.frames, clip.speed);
+    } else {
+      drawable.playAnimationOnce(clip.frames, null, clip.speed, () => {
+        if (this.current === name) this.current = null;
+      });
+    }
+    return this;
+  }
+
+  /**
+   * @method stop
+   * @description Stops the current animation.
+   */
+  stop() {
+    const drawable = this._resolveDrawable();
+    if (drawable) drawable.stopAnimation();
+    this.current = null;
+  }
+
+  /**
+   * @method getCurrent
+   * @description Returns the name of the currently playing clip (or null).
+   * @returns {string|null}
+   */
+  getCurrent() {
+    return this.current;
+  }
+}
+
+export default Animator;

package/src/BitmapText.js

@@ -35,7 +35,7 @@ class BitmapText {
     color,
     position,
     rotation,
-    useLighting = false // Default to false for text as it's typically UI
+    useLighting = false
   ) {
     this.text = text;
     this.texturePath = texturePath;
@@ -61,7 +61,6 @@ class BitmapText {
     for (let i = 0; i < letters.length; i++) {
       this.letterDictionary[letters[i]] = i;
     }
-    // Initialize the bitmap font texture
     this.texture = new InstancedTexture(
       this.texturePath,
       text.length,
@@ -75,14 +74,14 @@ class BitmapText {
       this.useLighting
     );
 
-    // Apply the color to the texture if provided
     if (this.color) {
       this.texture.setColor(this.color);
     }
 
-    // Apply the lighting setting to the texture
     this.texture.setUseLighting(this.useLighting);
 
+    this.texture.setStatic(true);
+
     this.gameObject.addComponent(this.texture);
     for (let i = 0; i < text.length; i++) {
       const letter = text[i];
@@ -163,7 +162,6 @@ class BitmapText {
    * @param {Vector3} position - The position to set
    */
   setPosition(position) {
-    // Vector3
     this.position = position;
     this.gameObject.transform.position = position;
 
@@ -184,6 +182,7 @@ class BitmapText {
         instanceIndex++;
       }
     }
+    this.texture.markDirty();
   }
 
   /**
@@ -212,6 +211,7 @@ class BitmapText {
         instanceIndex++;
       }
     }
+    this.texture.markDirty();
   }
 
   /**
@@ -239,6 +239,7 @@ class BitmapText {
         instanceIndex++;
       }
     }
+    this.texture.markDirty();
   }
 }