@jolly-pixel/engine 1.0.0

package/dist/components/camera/Camera3DControls.js

@@ -0,0 +1,79 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+import { Actor } from "../../actor/Actor.js";
+import { Behavior } from "../script/Behavior.js";
+export class Camera3DControls extends Behavior {
+    camera;
+    #bindings;
+    maxRollUp;
+    maxRollDown;
+    #rotationSpeed;
+    #movementSpeed;
+    constructor(actor, options = {}) {
+        super(actor);
+        this.camera = new THREE.PerspectiveCamera(45, window.innerWidth / window.innerHeight, 1, 10000);
+        this.#bindings = {
+            forward: options.bindings?.forward ?? "KeyW",
+            backward: options.bindings?.backward ?? "KeyS",
+            left: options.bindings?.left ?? "KeyA",
+            right: options.bindings?.right ?? "KeyD",
+            up: options.bindings?.up ?? "Space",
+            down: options.bindings?.down ?? "ShiftLeft",
+            lookAround: options.bindings?.lookAround ?? "middle"
+        };
+        this.maxRollUp = options.maxRollUp ?? Math.PI / 2;
+        this.maxRollDown = options.maxRollDown ?? -Math.PI / 2;
+        this.#rotationSpeed = options.rotationSpeed ?? 0.004;
+        this.#movementSpeed = options.speed ?? 20;
+        this.actor.gameInstance.renderer.addRenderComponent(this.camera);
+        this.camera.add(this.actor.gameInstance.audio.threeAudioListener);
+    }
+    set speed(speed) {
+        this.#movementSpeed = THREE.MathUtils.clamp(speed, 0.1, Infinity);
+    }
+    set rollSpeed(speed) {
+        this.#rotationSpeed = THREE.MathUtils.clamp(speed, 0.1, Infinity);
+    }
+    #rotate() {
+        const mouseDelta = this.actor.gameInstance.input.getMouseDelta(true);
+        const euler = new THREE.Euler(0, 0, 0, "YXZ");
+        euler.setFromQuaternion(this.camera.quaternion);
+        euler.y -= mouseDelta.x * this.#rotationSpeed;
+        euler.x += mouseDelta.y * this.#rotationSpeed;
+        euler.x = Math.max(this.maxRollDown, Math.min(this.maxRollUp, euler.x));
+        this.camera.quaternion.setFromEuler(euler);
+    }
+    update() {
+        const { input } = this.actor.gameInstance;
+        const vector = new THREE.Vector3(0);
+        if (input.isKeyDown(this.#bindings.forward)) {
+            vector.z -= 1;
+        }
+        if (input.isKeyDown(this.#bindings.backward)) {
+            vector.z += 1;
+        }
+        if (input.isKeyDown(this.#bindings.up)) {
+            vector.y += 1;
+        }
+        if (input.isKeyDown(this.#bindings.down)) {
+            vector.y -= 1;
+        }
+        if (input.isKeyDown(this.#bindings.right)) {
+            vector.x += 1;
+        }
+        if (input.isKeyDown(this.#bindings.left)) {
+            vector.x -= 1;
+        }
+        const translation = new THREE.Vector3(vector.x, 0, vector.z);
+        this.camera.translateOnAxis(translation.normalize(), this.#movementSpeed);
+        this.camera.position.y += vector.y * this.#movementSpeed;
+        if (input.isMouseButtonDown(this.#bindings.lookAround)) {
+            // input.mouse.lock();
+            this.#rotate();
+        }
+        else if (input.wasMouseButtonJustReleased(this.#bindings.lookAround)) {
+            // input.mouse.unlock();
+        }
+    }
+}
+//# sourceMappingURL=Camera3DControls.js.map

package/dist/components/camera/Camera3DControls.js.map

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

package/dist/components/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./camera/Camera3DControls.ts";
+export * from "./renderers/index.ts";
+export * from "./script/Behavior.ts";
+export { SceneProperty, SceneActorComponent, type ScenePropertyOptions } from "./script/BehaviorDecorators.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AAErC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,KAAK,oBAAoB,EAC1B,MAAM,gCAAgC,CAAC"}

package/dist/components/index.js

@@ -0,0 +1,5 @@
+export * from "./camera/Camera3DControls.js";
+export * from "./renderers/index.js";
+export * from "./script/Behavior.js";
+export { SceneProperty, SceneActorComponent } from "./script/BehaviorDecorators.js";
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sBAAsB,CAAC;AAErC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,aAAa,EACb,mBAAmB,EAEpB,MAAM,gCAAgC,CAAC"}

package/dist/components/renderers/index.d.ts

@@ -0,0 +1,14 @@
+export * from "./sprite/SpriteRenderer.class.ts";
+export * from "./tiled/TileMapRenderer.ts";
+export * from "./model/ModelRenderer.ts";
+export * from "./text/TextRenderer.class.ts";
+import { type TiledSetAsset, type TiledMapAsset } from "./tiled/loader.ts";
+import { type Model } from "./model/loader.ts";
+import { type Font } from "./text/loader.ts";
+export declare const Loaders: {
+    readonly tiledMap: (assetOrPath: import("../../systems/index.ts").Asset | string) => import("../../systems/index.ts").LazyAsset<TiledMapAsset>;
+    readonly model: (assetOrPath: import("../../systems/index.ts").Asset | string) => import("../../systems/index.ts").LazyAsset<Model>;
+    readonly font: (assetOrPath: import("../../systems/index.ts").Asset | string) => import("../../systems/index.ts").LazyAsset<Font>;
+};
+export type { TiledSetAsset, TiledMapAsset, Model, Font };
+//# sourceMappingURL=index.d.ts.map

package/dist/components/renderers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/renderers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAG7C,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,KAAK,EACX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,IAAI,EACV,MAAM,kBAAkB,CAAC;AAE1B,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AAEX,YAAY,EACV,aAAa,EACb,aAAa,EACb,KAAK,EACL,IAAI,EACL,CAAC"}

package/dist/components/renderers/index.js

@@ -0,0 +1,14 @@
+export * from "./sprite/SpriteRenderer.class.js";
+export * from "./tiled/TileMapRenderer.js";
+export * from "./model/ModelRenderer.js";
+export * from "./text/TextRenderer.class.js";
+// Import Internal Dependencies
+import { tiledMap } from "./tiled/loader.js";
+import { model } from "./model/loader.js";
+import { font } from "./text/loader.js";
+export const Loaders = {
+    tiledMap,
+    model,
+    font
+};
+//# sourceMappingURL=index.js.map

package/dist/components/renderers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/renderers/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAE7C,+BAA+B;AAC/B,OAAO,EACL,QAAQ,EAGT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,EAEN,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,IAAI,EAEL,MAAM,kBAAkB,CAAC;AAE1B,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,QAAQ;IACR,KAAK;IACL,IAAI;CACI,CAAC"}

package/dist/components/renderers/model/ModelAnimation.d.ts

@@ -0,0 +1,21 @@
+import * as THREE from "three";
+export type ModelAnimationClipNameRewriter = (clipName: string) => string;
+export interface ModelAnimationNext {
+    action: THREE.AnimationAction;
+    fadeDuration: number;
+}
+export interface ModelAnimationPlayOptions {
+    fadeDuration?: number;
+}
+export declare class ModelAnimation {
+    #private;
+    setMixer(mixer: THREE.AnimationMixer): this;
+    setClipNameRewriter(rewriter: ModelAnimationClipNameRewriter): this;
+    setClips(clips: THREE.AnimationClip[]): this;
+    setFadeDuration(duration: number): this;
+    play(animationName: string, options?: ModelAnimationPlayOptions): void;
+    stop(): void;
+    start(): void;
+    update(deltaTime: number): void;
+}
+//# sourceMappingURL=ModelAnimation.d.ts.map

package/dist/components/renderers/model/ModelAnimation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelAnimation.d.ts","sourceRoot":"","sources":["../../../../src/components/renderers/model/ModelAnimation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,MAAM,8BAA8B,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;AAE1E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAc;;IAYzB,QAAQ,CACN,KAAK,EAAE,KAAK,CAAC,cAAc;IAO7B,mBAAmB,CACjB,QAAQ,EAAE,8BAA8B;IAc1C,QAAQ,CACN,KAAK,EAAE,KAAK,CAAC,aAAa,EAAE;IAU9B,eAAe,CACb,QAAQ,EAAE,MAAM;IAOlB,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,yBAA8B;IAuBzC,IAAI;IAOJ,KAAK;IAOL,MAAM,CACJ,SAAS,EAAE,MAAM;CAoBpB"}

package/dist/components/renderers/model/ModelAnimation.js

@@ -0,0 +1,84 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+export class ModelAnimation {
+    #mixer;
+    #clipNameRewriter = (name) => name;
+    #clips = new Map();
+    #fadeDuration = 1;
+    #last = null;
+    #current = null;
+    #nextAnimationName;
+    #next = null;
+    setMixer(mixer) {
+        this.#mixer = mixer;
+        return this;
+    }
+    setClipNameRewriter(rewriter) {
+        this.#clipNameRewriter = rewriter;
+        if (this.#clips.size > 0) {
+            const renamedClips = new Map();
+            for (const [name, action] of this.#clips) {
+                renamedClips.set(this.#clipNameRewriter(name), action);
+            }
+            this.#clips = renamedClips;
+        }
+        return this;
+    }
+    setClips(clips) {
+        for (const clip of clips) {
+            const action = this.#mixer.clipAction(clip);
+            this.#clips.set(this.#clipNameRewriter(clip.name), action);
+        }
+        return this;
+    }
+    setFadeDuration(duration) {
+        this.#fadeDuration = duration;
+        return this;
+    }
+    play(animationName, options = {}) {
+        if (!this.#mixer) {
+            this.#nextAnimationName = animationName;
+            return;
+        }
+        const { fadeDuration = this.#fadeDuration } = options;
+        const clip = this.#clips.get(animationName);
+        if (!clip) {
+            throw new Error(`Animation clip "${animationName}" not found!`);
+        }
+        if (clip !== this.#current) {
+            this.#next = {
+                action: clip,
+                fadeDuration
+            };
+        }
+    }
+    stop() {
+        if (this.#current) {
+            this.#current.stop();
+            this.#current = null;
+        }
+    }
+    start() {
+        if (this.#nextAnimationName) {
+            this.play(this.#nextAnimationName);
+            this.#nextAnimationName = undefined;
+        }
+    }
+    update(deltaTime) {
+        if (!this.#mixer) {
+            return;
+        }
+        if (this.#next && this.#next.action !== this.#current) {
+            const fadeDuration = this.#next.fadeDuration;
+            if (this.#current) {
+                this.#last = this.#current;
+                this.#last.fadeOut(fadeDuration);
+            }
+            this.#current = this.#next.action;
+            this.#current.reset().fadeIn(fadeDuration).play();
+        }
+        this.#next = null;
+        this.#mixer.update(deltaTime);
+    }
+}
+//# sourceMappingURL=ModelAnimation.js.map

package/dist/components/renderers/model/ModelAnimation.js.map

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

package/dist/components/renderers/model/ModelRenderer.d.ts

@@ -0,0 +1,24 @@
+import { Actor, ActorComponent } from "../../../actor/index.ts";
+import { ModelAnimation, type ModelAnimationClipNameRewriter } from "./ModelAnimation.ts";
+export interface ModelRendererAnimationOptions {
+    clipNameRewriter?: ModelAnimationClipNameRewriter;
+    default?: string;
+}
+export interface ModelRendererOptions {
+    path: string;
+    /**
+     * @default false
+     */
+    debug?: boolean;
+    animations?: ModelRendererAnimationOptions;
+}
+export declare class ModelRenderer extends ActorComponent {
+    #private;
+    animation: ModelAnimation;
+    constructor(actor: Actor, options: ModelRendererOptions);
+    awake(): void;
+    start(): void;
+    update(deltaTime: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ModelRenderer.d.ts.map

package/dist/components/renderers/model/ModelRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRenderer.d.ts","sourceRoot":"","sources":["../../../../src/components/renderers/model/ModelRenderer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGhE,OAAO,EACL,cAAc,EACd,KAAK,8BAA8B,EACpC,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,6BAA6B;IAC5C,gBAAgB,CAAC,EAAE,8BAA8B,CAAC;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,6BAA6B,CAAC;CAC5C;AAED,qBAAa,aAAc,SAAQ,cAAc;;IAK/C,SAAS,iBAAwB;gBAG/B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,oBAAoB;IAmB/B,KAAK;IAcL,KAAK;IAIL,MAAM,CACJ,SAAS,EAAE,MAAM;IAKV,OAAO,IAAI,IAAI;CAIzB"}

package/dist/components/renderers/model/ModelRenderer.js

@@ -0,0 +1,49 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+// Import Internal Dependencies
+import * as Systems from "../../../systems/index.js";
+import { Actor, ActorComponent } from "../../../actor/index.js";
+import { model } from "./loader.js";
+import { ModelAnimation } from "./ModelAnimation.js";
+export class ModelRenderer extends ActorComponent {
+    #asset;
+    #object;
+    #debug = false;
+    animation = new ModelAnimation();
+    constructor(actor, options) {
+        super({
+            actor,
+            typeName: "ModelRenderer"
+        });
+        this.#asset = model(options.path);
+        this.#debug = options.debug ?? false;
+        const { animations = {} } = options;
+        if (animations.default) {
+            this.animation.play(animations.default);
+        }
+        if (animations.clipNameRewriter) {
+            this.animation.setClipNameRewriter(animations.clipNameRewriter);
+        }
+    }
+    awake() {
+        const { object, animations } = this.#asset.get();
+        if (this.#debug) {
+            console.log({ object, animations });
+        }
+        this.actor.threeObject.add(object);
+        this.#object = object;
+        this.animation.setMixer(new THREE.AnimationMixer(this.#object));
+        this.animation.setClips(animations);
+    }
+    start() {
+        this.animation.start();
+    }
+    update(deltaTime) {
+        this.animation.update(deltaTime);
+    }
+    destroy() {
+        this.actor.threeObject.remove(this.#object);
+        super.destroy();
+    }
+}
+//# sourceMappingURL=ModelRenderer.js.map

package/dist/components/renderers/model/ModelRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRenderer.js","sourceRoot":"","sources":["../../../../src/components/renderers/model/ModelRenderer.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,+BAA+B;AAC/B,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAc,MAAM,aAAa,CAAC;AAEhD,OAAO,EACL,cAAc,EAEf,MAAM,qBAAqB,CAAC;AAgB7B,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,MAAM,CAA2B;IACjC,OAAO,CAAsC;IAC7C,MAAM,GAAG,KAAK,CAAC;IAEf,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;IAEjC,YACE,KAAY,EACZ,OAA6B;QAE7B,KAAK,CAAC;YACJ,KAAK;YACL,QAAQ,EAAE,eAAe;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;QAErC,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;QACpC,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,KAAK;QACH,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,SAAS,CAAC,QAAQ,CACrB,IAAI,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CACvC,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,CACJ,SAAiB;QAEjB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC;IAEQ,OAAO;QACd,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC5C,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/components/renderers/model/loader.d.ts

@@ -0,0 +1,8 @@
+import * as THREE from "three";
+import { Asset } from "../../../systems/index.ts";
+export type Model = {
+    object: THREE.Group<THREE.Object3DEventMap>;
+    animations: THREE.AnimationClip[];
+};
+export declare const model: (assetOrPath: Asset | string) => import("../../../systems/index.ts").LazyAsset<Model>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/components/renderers/model/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/components/renderers/model/loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAO/B,OAAO,EACL,KAAK,EAGN,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,KAAK,GAAG;IAClB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC5C,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;CACnC,CAAC;AAqBF,eAAO,MAAM,KAAK,uFAA2B,CAAC"}

package/dist/components/renderers/model/loader.js

@@ -0,0 +1,112 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+import { OBJLoader } from "three/addons/loaders/OBJLoader.js";
+import { MTLLoader } from "three/addons/loaders/MTLLoader.js";
+import { FBXLoader } from "three/addons/loaders/FBXLoader.js";
+import { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+// Import Internal Dependencies
+import { Asset, Assets } from "../../../systems/index.js";
+Assets.registry.loader({
+    extensions: [".obj", ".fbx", ".glb", ".gltf"],
+    type: "model"
+}, (asset, context) => {
+    switch (asset.ext) {
+        case ".obj":
+            return safeLoad(asset, objectLoader(asset, context));
+        case ".fbx":
+            return safeLoad(asset, fbxLoader(asset, context));
+        case ".glb":
+        case ".gltf":
+            return safeLoad(asset, gltfLoader(asset, context));
+        default:
+            throw new Error(`Unsupported model type: ${asset.ext}`);
+    }
+});
+export const model = Assets.lazyLoad();
+async function objectLoader(asset, context) {
+    const { manager } = context;
+    const objLoader = new OBJLoader(manager)
+        .setPath(asset.path);
+    const mtlLoader = new MTLLoader(manager)
+        .setPath(asset.path);
+    const materials = await mtlLoader.loadAsync(asset.name + ".mtl");
+    const object = await objLoader
+        .setMaterials(loadMTLMaterials(materials))
+        .loadAsync(asset.basename);
+    object.name = asset.name;
+    return {
+        object,
+        animations: []
+    };
+}
+function loadMTLMaterials(materials) {
+    materials.preload();
+    for (const material of Object.values(materials.materials)) {
+        if (isMaterialWithMap(material) && material.map) {
+            material.map.magFilter = THREE.NearestFilter;
+        }
+    }
+    return materials;
+}
+async function fbxLoader(asset, context) {
+    const { manager } = context;
+    const loader = new FBXLoader(manager)
+        .setPath(asset.path);
+    const object = await loader.loadAsync(asset.basename);
+    object.name = asset.name;
+    object.traverse((child) => {
+        if (child instanceof THREE.Mesh) {
+            child.castShadow = true;
+            child.receiveShadow = true;
+            const materials = Array.from(extractMaterials(object));
+            for (const material of materials) {
+                if (material.map) {
+                    material.map.magFilter = THREE.NearestFilter;
+                }
+            }
+        }
+    });
+    return {
+        object,
+        animations: object.animations
+    };
+}
+async function gltfLoader(asset, context) {
+    const { manager } = context;
+    const loader = new GLTFLoader(manager)
+        .setPath(asset.path);
+    const object = await loader.loadAsync(asset.basename);
+    return {
+        object: object.scene,
+        animations: object.animations
+    };
+}
+function* extractMaterials(object) {
+    for (const child of object.children) {
+        if (child instanceof THREE.Mesh) {
+            const materials = Array.isArray(child.material) ? child.material : [child.material];
+            for (const material of materials) {
+                if (isMaterialWithMap(material)) {
+                    yield material;
+                }
+            }
+        }
+        else if (child instanceof THREE.Object3D) {
+            yield* extractMaterials(child);
+        }
+    }
+}
+function isMaterialWithMap(material) {
+    return (material instanceof THREE.MeshStandardMaterial ||
+        material instanceof THREE.MeshPhongMaterial);
+}
+async function safeLoad(asset, loader) {
+    try {
+        const model = await loader;
+        return model;
+    }
+    catch (error) {
+        throw new Error(`Failed to load model: ${asset.toString()}`, { cause: error });
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/components/renderers/model/loader.js.map

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

package/dist/components/renderers/sprite/SpriteAnimation.class.d.ts

@@ -0,0 +1,33 @@
+import * as THREE from "three";
+export interface SpriteAnimationRange {
+    from: number;
+    to: number;
+}
+export interface SpriteAnimationOptions {
+    [key: string]: (number[] | SpriteAnimationRange);
+}
+export interface SpriteRunningAnimation {
+    name: string;
+    frames: number[];
+    frameIndex: number;
+    loop: boolean;
+    maxDuration: number;
+    clock: THREE.Clock;
+}
+export interface SpriteAnimationPlayOptions {
+    loop?: boolean;
+    duration: number;
+}
+export declare class SpriteAnimation {
+    #private;
+    animations: Map<string, number[]>;
+    animation: SpriteRunningAnimation | null;
+    constructor(animations: SpriteAnimationOptions);
+    get isPlaying(): boolean;
+    play(animationName: string, options: SpriteAnimationPlayOptions): void;
+    pause(): void;
+    resume(): void;
+    stop(): void;
+    update(): null | number;
+}
+//# sourceMappingURL=SpriteAnimation.class.d.ts.map

package/dist/components/renderers/sprite/SpriteAnimation.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteAnimation.class.d.ts","sourceRoot":"","sources":["../../../../src/components/renderers/sprite/SpriteAnimation.class.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,sBAAsB;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,GAAG,oBAAoB,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,eAAe;;IAG1B,UAAU,wBAA+B;IACzC,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAQ;gBAG9C,UAAU,EAAE,sBAAsB;IAYpC,IAAI,SAAS,YAEZ;IAED,IAAI,CACF,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,0BAA0B;IAsBrC,KAAK;IASL,MAAM;IASN,IAAI;IAKJ,MAAM,IAAI,IAAI,GAAG,MAAM;CAuBxB"}

package/dist/components/renderers/sprite/SpriteAnimation.class.js

@@ -0,0 +1,78 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+export class SpriteAnimation {
+    #isPlaying = false;
+    animations = new Map();
+    animation = null;
+    constructor(animations) {
+        for (const [name, value] of Object.entries(animations)) {
+            if (Array.isArray(value)) {
+                this.animations.set(name, value);
+            }
+            else {
+                this.animations.set(name, Array.from(range(value.from, value.to)));
+            }
+        }
+    }
+    get isPlaying() {
+        return this.#isPlaying;
+    }
+    play(animationName, options) {
+        const { loop = false, duration } = options;
+        const animation = this.animations.get(animationName);
+        if (!animation) {
+            console.warn(`Animation "${animationName}" not found.`);
+            return;
+        }
+        this.animation = {
+            name: animationName,
+            frames: animation.slice(0),
+            frameIndex: 0,
+            loop,
+            maxDuration: duration / animation.length,
+            clock: new THREE.Clock(true)
+        };
+        this.#isPlaying = true;
+    }
+    pause() {
+        if (!this.animation) {
+            return;
+        }
+        this.#isPlaying = false;
+        this.animation.clock.stop();
+    }
+    resume() {
+        if (!this.animation) {
+            return;
+        }
+        this.#isPlaying = true;
+        this.animation.clock.start();
+    }
+    stop() {
+        this.animation = null;
+        this.#isPlaying = false;
+    }
+    update() {
+        if (!this.isPlaying || !this.animation) {
+            return null;
+        }
+        const elapsedTime = this.animation.clock.getElapsedTime();
+        if (this.animation.maxDuration > 0 &&
+            elapsedTime >= this.animation.maxDuration) {
+            this.animation.clock = new THREE.Clock(true);
+            this.animation.frameIndex = (this.animation.frameIndex + 1) % this.animation.frames.length;
+            const frameId = this.animation.frames[this.animation.frameIndex];
+            if (!this.animation.loop) {
+                this.animation = null;
+            }
+            return frameId;
+        }
+        return null;
+    }
+}
+function* range(from, to) {
+    for (let i = from; i <= to; i++) {
+        yield i;
+    }
+}
+//# sourceMappingURL=SpriteAnimation.class.js.map

package/dist/components/renderers/sprite/SpriteAnimation.class.js.map

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

package/dist/components/renderers/sprite/SpriteRenderer.class.d.ts

@@ -0,0 +1,35 @@
+import * as THREE from "three";
+import { Actor, ActorComponent } from "../../../actor/index.ts";
+import { SpriteAnimation, type SpriteAnimationOptions } from "./SpriteAnimation.class.ts";
+export interface SpriteRendererOptions {
+    texture: string;
+    tileHorizontal: number;
+    tileVertical: number;
+    animations?: SpriteAnimationOptions;
+    flip?: {
+        horizontal?: boolean;
+        vertical?: boolean;
+    };
+}
+export declare class SpriteRenderer extends ActorComponent {
+    frameIndex: number;
+    tileHorizontal: number;
+    tileVertical: number;
+    flip: {
+        horizontal: boolean;
+        vertical: boolean;
+    };
+    texture: THREE.Texture;
+    animation: SpriteAnimation;
+    threeObject: THREE.Sprite;
+    constructor(actor: Actor, options: SpriteRendererOptions);
+    setHorizontalFlip(value: boolean): void;
+    setVerticalFlip(value: boolean): void;
+    setOpacity(opacity: number): void;
+    start(): void;
+    setFrame(index: number): void;
+    update(): void;
+    destroy(): void;
+}
+export type { SpriteAnimationOptions };
+//# sourceMappingURL=SpriteRenderer.class.d.ts.map