@certe/atmos-core 0.1.0

package/README.md

@@ -0,0 +1,171 @@
+# 🧩 @certe/atmos-core
+
+The heart of the Atmos Engine — game loop, scene graph, component model, input, and serialization. This package has no rendering or physics code; it defines the contracts that all other packages build on.
+
+---
+
+## 🔑 Key Concepts
+
+### Component Lifecycle
+
+Every component follows a strict lifecycle:
+
+```
+onAwake()  →  onStart()  →  onUpdate(dt)  →  onRender()  →  onDestroy()
+   once          once        every frame      every frame      once
+```
+
+```ts
+import { Component } from '@certe/atmos-core';
+
+class Rotator extends Component {
+  speed = 1;
+
+  onUpdate(dt: number) {
+    const r = this.gameObject.transform.rotation;
+    Quat.rotateY(r, r, this.speed * dt);
+    this.gameObject.transform.rotation = r; // triggers dirty flag
+  }
+}
+```
+
+### GameObject & Transform
+
+Every `GameObject` has a unique ID and always carries a `Transform`:
+
+```ts
+const cube = new GameObject('Cube');
+cube.transform.setPosition(0, 5, 0);
+cube.transform.setScale(2, 2, 2);
+
+const child = new GameObject('Child');
+child.setParent(cube); // inherits parent's world matrix
+```
+
+Transform uses a **dirty flag system** — local matrix recomputes only when TRS changes, and world matrix propagates through the parent chain.
+
+---
+
+## 🚀 Quick Start
+
+```ts
+import { Engine, Scene, GameObject, Time, Input } from '@certe/atmos-core';
+
+const scene = new Scene();
+const player = new GameObject('Player');
+player.addComponent(MyController);
+scene.add(player);
+
+const engine = new Engine();
+engine.start(scene);
+```
+
+---
+
+## 📖 API Overview
+
+### Engine
+
+The main loop orchestrator. Frame order:
+
+```
+Input.endFrame() → Physics.step() → Scene.updateAll(dt) → Render
+```
+
+| Method / Property | Description |
+|---|---|
+| `start(scene)` | Begin the game loop |
+| `stop()` | Stop the loop |
+| `paused` | Get/set — skips physics & scripts when true |
+| `scene` | Set to swap scenes at runtime |
+| `setRenderer(r)` | Provide a renderer implementation |
+| `setPhysics(p)` | Provide a physics stepper |
+
+### Scene
+
+Container for GameObjects. Manages lifecycle propagation.
+
+| Method | Description |
+|---|---|
+| `add(obj)` | Add a GameObject (and children) |
+| `remove(obj)` | Remove and call onDestroy on all components |
+| `getAllObjects()` | `ReadonlySet<GameObject>` |
+| `findAll<T>(Ctor)` | Find all components of a type |
+| `awakeAll()` / `startAll()` / `updateAll(dt)` / `renderAll()` | Lifecycle phases |
+
+### Input
+
+Keyboard and mouse state, frame-deterministic:
+
+```ts
+if (Input.getKeyDown('Space')) jump();
+if (Input.getKey('KeyW')) moveForward(dt);
+const { x, y } = input.mousePosition;
+```
+
+### Time
+
+```ts
+Time.deltaTime   // seconds since last frame (clamped to 100ms)
+Time.time        // accumulated seconds
+Time.frameCount  // integer frame counter
+```
+
+### Component Registry
+
+Register components at startup so the editor and serializer know about them:
+
+```ts
+import { registerComponent } from '@certe/atmos-core';
+
+registerComponent(Rotator, {
+  name: 'Rotator',
+  properties: [
+    { key: 'speed', type: 'number', default: 1, min: 0, max: 10 },
+  ],
+});
+```
+
+### Scene Serialization
+
+```ts
+import { serializeScene, deserializeScene } from '@certe/atmos-core';
+
+const data = serializeScene(scene);           // → JSON-safe SceneData
+const restored = deserializeScene(data, ctx); // → new Scene
+```
+
+The serializer handles Transform, parent-child relationships, component data, and `gameObjectRef` resolution across a 3-pass process.
+
+---
+
+## 🧠 Design Principles
+
+- **No circular dependencies** — Component ↔ Scene link uses late binding
+- **Deterministic execution** — fixed update order, frame-deterministic input
+- **Composition over inheritance** — components attached to GameObjects
+- **Strict TypeScript** — no `any`, all public APIs typed
+
+---
+
+## 📁 Structure
+
+```
+packages/core/src/
+  index.ts              # Public API
+  component.ts          # Abstract Component base class
+  game-object.ts        # GameObject with Transform
+  transform.ts          # TRS + dirty flags + hierarchy
+  scene.ts              # Scene graph + lifecycle
+  engine.ts             # Main loop
+  input.ts              # Keyboard/mouse
+  time.ts               # Frame timing
+  component-registry.ts # Property metadata
+  scene-serializer.ts   # Save/load scenes
+```
+
+---
+
+## 🔗 Dependencies
+
+- `@certe/atmos-math` — Vec3, Mat4, Quat for Transform

package/dist/component-registry.d.ts

@@ -0,0 +1,60 @@
+export type PropertyType = 'number' | 'string' | 'boolean' | 'vec3' | 'quat' | 'color' | 'enum' | 'gameObjectRef' | 'materialAsset';
+export interface PropertyDefBase {
+    visibleWhen?: (target: unknown) => boolean;
+}
+export interface NumberPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'number';
+    min?: number;
+    max?: number;
+    step?: number;
+}
+export interface Vec3PropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'vec3';
+}
+export interface QuatPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'quat';
+}
+export interface ColorPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'color';
+}
+export interface EnumPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'enum';
+    options: string[];
+    /** When present, inspector uses this instead of static `options` for dynamic enum values. */
+    optionsFrom?: (target: unknown) => string[];
+}
+export interface StringPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'string';
+}
+export interface BooleanPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'boolean';
+}
+export interface GameObjectRefPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'gameObjectRef';
+}
+export interface MaterialAssetPropertyDef extends PropertyDefBase {
+    key: string;
+    type: 'materialAsset';
+}
+export type PropertyDef = NumberPropertyDef | Vec3PropertyDef | QuatPropertyDef | ColorPropertyDef | EnumPropertyDef | StringPropertyDef | BooleanPropertyDef | GameObjectRefPropertyDef | MaterialAssetPropertyDef;
+export interface ComponentDef {
+    name: string;
+    properties: PropertyDef[];
+    /** When true, multiple instances of this component can be added to the same GameObject. */
+    allowMultiple?: boolean;
+}
+type ComponentConstructor = abstract new (...args: any[]) => any;
+export declare function registerComponent(ctor: ComponentConstructor, def: ComponentDef): void;
+export declare function getComponentDef(ctor: ComponentConstructor): ComponentDef | undefined;
+export declare function getAllRegisteredComponents(): Map<ComponentConstructor, ComponentDef>;
+export declare function clearRegistry(): void;
+export {};
+//# sourceMappingURL=component-registry.d.ts.map

package/dist/component-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.d.ts","sourceRoot":"","sources":["../src/component-registry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,CAAC;AAEpI,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6FAA6F;IAC7F,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,iBAAkB,SAAQ,eAAe;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GACnB,iBAAiB,GACjB,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,iBAAiB,GACjB,kBAAkB,GAClB,wBAAwB,GACxB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAGD,KAAK,oBAAoB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAIjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,oBAAoB,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAErF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,YAAY,GAAG,SAAS,CAEpF;AAED,wBAAgB,0BAA0B,IAAI,GAAG,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAEpF;AAED,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/component-registry.js

@@ -0,0 +1,14 @@
+const registry = new Map();
+export function registerComponent(ctor, def) {
+    registry.set(ctor, def);
+}
+export function getComponentDef(ctor) {
+    return registry.get(ctor);
+}
+export function getAllRegisteredComponents() {
+    return new Map(registry);
+}
+export function clearRegistry() {
+    registry.clear();
+}
+//# sourceMappingURL=component-registry.js.map

package/dist/component-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry.js","sourceRoot":"","sources":["../src/component-registry.ts"],"names":[],"mappings":"AA8EA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsC,CAAC;AAE/D,MAAM,UAAU,iBAAiB,CAAC,IAA0B,EAAE,GAAiB;IAC7E,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAA0B;IACxD,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/component.d.ts

@@ -0,0 +1,19 @@
+import type { GameObject } from './game-object.js';
+import type { Scene } from './scene.js';
+export declare function _setSceneClass(cls: typeof Scene): void;
+export declare abstract class Component {
+    gameObject: GameObject;
+    enabled: boolean;
+    onAwake?(): void;
+    onStart?(): void;
+    onUpdate?(dt: number): void;
+    onRender?(): void;
+    onDestroy?(): void;
+    /** Get a sibling component on the same GameObject. */
+    getComponent<T extends Component>(Ctor: new (...args: never[]) => T): T | null;
+    /** Get all sibling components of a given type on the same GameObject. */
+    getAllComponents<T extends Component>(Ctor: new (...args: never[]) => T): T[];
+    /** Find all components of a given type in the current scene. */
+    static findAll<T extends Component>(Ctor: new (...args: never[]) => T): T[];
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAIxC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,KAAK,GAAG,IAAI,CAAuB;AAE9E,8BAAsB,SAAS;IAC7B,UAAU,EAAG,UAAU,CAAC;IACxB,OAAO,UAAQ;IAEf,OAAO,CAAC,IAAI,IAAI;IAChB,OAAO,CAAC,IAAI,IAAI;IAChB,QAAQ,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAC3B,QAAQ,CAAC,IAAI,IAAI;IACjB,SAAS,CAAC,IAAI,IAAI;IAElB,sDAAsD;IACtD,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAI9E,yEAAyE;IACzE,gBAAgB,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE;IAI7E,gEAAgE;IAChE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE;CAK5E"}

package/dist/component.js

@@ -0,0 +1,23 @@
+/** Set by Scene module at import time to break circular dependency. */
+let _sceneClass = null;
+export function _setSceneClass(cls) { _sceneClass = cls; }
+export class Component {
+    gameObject;
+    enabled = true;
+    /** Get a sibling component on the same GameObject. */
+    getComponent(Ctor) {
+        return this.gameObject.getComponent(Ctor);
+    }
+    /** Get all sibling components of a given type on the same GameObject. */
+    getAllComponents(Ctor) {
+        return this.gameObject.getComponents().filter((c) => c instanceof Ctor);
+    }
+    /** Find all components of a given type in the current scene. */
+    static findAll(Ctor) {
+        const current = _sceneClass?.current;
+        if (!current)
+            return [];
+        return current.findAll(Ctor);
+    }
+}
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,IAAI,WAAW,GAAwB,IAAI,CAAC;AAC5C,MAAM,UAAU,cAAc,CAAC,GAAiB,IAAU,WAAW,GAAG,GAAG,CAAC,CAAC,CAAC;AAE9E,MAAM,OAAgB,SAAS;IAC7B,UAAU,CAAc;IACxB,OAAO,GAAG,IAAI,CAAC;IAQf,sDAAsD;IACtD,YAAY,CAAsB,IAAiC;QACjE,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,yEAAyE;IACzE,gBAAgB,CAAsB,IAAiC;QACrE,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAU,EAAE,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;IAClF,CAAC;IAED,gEAAgE;IAChE,MAAM,CAAC,OAAO,CAAsB,IAAiC;QACnE,MAAM,OAAO,GAAG,WAAW,EAAE,OAAO,CAAC;QACrC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QACxB,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/engine.d.ts

@@ -0,0 +1,32 @@
+import { Scene } from './scene.js';
+import { Time } from './time.js';
+import { Input } from './input.js';
+export interface Renderer {
+    beginFrame(): void;
+    endFrame(): void;
+}
+export interface PhysicsStepper {
+    step(dt: number): void;
+}
+export declare class Engine {
+    readonly time: Time;
+    readonly input: Input;
+    private _scene;
+    private _renderer;
+    private _physics;
+    private _running;
+    private _paused;
+    private _rafId;
+    setRenderer(renderer: Renderer): void;
+    setPhysics(physics: PhysicsStepper): void;
+    start(scene: Scene): void;
+    stop(): void;
+    get running(): boolean;
+    get paused(): boolean;
+    set paused(value: boolean);
+    set scene(s: Scene);
+    /** Exposed for testing: run a single frame tick manually */
+    tick(timestamp: number): void;
+    private _loop;
+}
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,WAAW,QAAQ;IACvB,UAAU,IAAI,IAAI,CAAC;IACnB,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,qBAAa,MAAM;IACjB,QAAQ,CAAC,IAAI,OAAc;IAC3B,QAAQ,CAAC,KAAK,QAAe;IAE7B,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;IAEnB,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAIrC,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIzC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAgBzB,IAAI,IAAI,IAAI;IAQZ,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAExB;IAED,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,EAIjB;IAED,4DAA4D;IAC5D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAa7B,OAAO,CAAC,KAAK;CAKd"}

package/dist/engine.js

@@ -0,0 +1,75 @@
+import { Scene } from './scene.js';
+import { Time } from './time.js';
+import { Input } from './input.js';
+export class Engine {
+    time = new Time();
+    input = new Input();
+    _scene = null;
+    _renderer = null;
+    _physics = null;
+    _running = false;
+    _paused = false;
+    _rafId = 0;
+    setRenderer(renderer) {
+        this._renderer = renderer;
+    }
+    setPhysics(physics) {
+        this._physics = physics;
+    }
+    start(scene) {
+        if (this._running)
+            return;
+        this._scene = scene;
+        Scene.current = scene;
+        Input.current = this.input;
+        this._running = true;
+        this.time.reset();
+        if (!this._paused) {
+            scene.awakeAll();
+            scene.startAll();
+        }
+        this._rafId = requestAnimationFrame((ts) => this._loop(ts));
+    }
+    stop() {
+        this._running = false;
+        if (this._rafId) {
+            cancelAnimationFrame(this._rafId);
+            this._rafId = 0;
+        }
+    }
+    get running() {
+        return this._running;
+    }
+    get paused() {
+        return this._paused;
+    }
+    set paused(value) {
+        this._paused = value;
+    }
+    set scene(s) {
+        this._scene = s;
+        Scene.current = s;
+        Input.current = this.input;
+    }
+    /** Exposed for testing: run a single frame tick manually */
+    tick(timestamp) {
+        if (!this._scene)
+            return;
+        this.time.update(timestamp);
+        this.input.endFrame();
+        if (!this._paused) {
+            this._physics?.step(this.time.deltaTime);
+            this._scene.updateAll(this.time.deltaTime);
+        }
+        this._renderer?.beginFrame();
+        this._scene.renderAll();
+        this._renderer?.endFrame();
+    }
+    _loop(timestamp) {
+        if (!this._running)
+            return;
+        this.tick(timestamp);
+        this._rafId = requestAnimationFrame((ts) => this._loop(ts));
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/game-object.d.ts

@@ -0,0 +1,23 @@
+import { Component } from './component.js';
+import { Transform } from './transform.js';
+export declare class GameObject {
+    readonly id: number;
+    readonly transform: Transform;
+    name: string;
+    /** If true, this object and its children are skipped during serialization. */
+    transient: boolean;
+    private readonly _components;
+    private _parent;
+    private readonly _children;
+    constructor(name?: string);
+    get parent(): GameObject | null;
+    get children(): readonly GameObject[];
+    setParent(parent: GameObject | null): void;
+    addComponent<T extends Component>(Ctor: new () => T): T;
+    getComponent<T extends Component>(Ctor: new (...args: never[]) => T): T | null;
+    getComponents(): readonly Component[];
+    removeComponent(component: Component): void;
+}
+/** Reset ID counter (for testing only) */
+export declare function resetGameObjectIds(): void;
+//# sourceMappingURL=game-object.d.ts.map

package/dist/game-object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-object.d.ts","sourceRoot":"","sources":["../src/game-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C,qBAAa,UAAU;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,YAAmB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,UAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;gBAElC,IAAI,SAAe;IAK/B,IAAI,MAAM,IAAI,UAAU,GAAG,IAAI,CAE9B;IAED,IAAI,QAAQ,IAAI,SAAS,UAAU,EAAE,CAEpC;IAED,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI;IAa1C,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC;IAOvD,YAAY,CAAC,CAAC,SAAS,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI;IAO9E,aAAa,IAAI,SAAS,SAAS,EAAE;IAIrC,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;CAO5C;AAED,0CAA0C;AAC1C,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/game-object.js

@@ -0,0 +1,65 @@
+import { Transform } from './transform.js';
+let nextId = 1;
+export class GameObject {
+    id;
+    transform = new Transform();
+    name;
+    /** If true, this object and its children are skipped during serialization. */
+    transient = false;
+    _components = [];
+    _parent = null;
+    _children = [];
+    constructor(name = 'GameObject') {
+        this.id = nextId++;
+        this.name = name;
+    }
+    get parent() {
+        return this._parent;
+    }
+    get children() {
+        return this._children;
+    }
+    setParent(parent) {
+        if (this._parent === parent)
+            return;
+        if (this._parent) {
+            const idx = this._parent._children.indexOf(this);
+            if (idx !== -1)
+                this._parent._children.splice(idx, 1);
+        }
+        this._parent = parent;
+        if (parent) {
+            parent._children.push(this);
+        }
+        this.transform.setParent(parent ? parent.transform : null);
+    }
+    addComponent(Ctor) {
+        const component = new Ctor();
+        component.gameObject = this;
+        this._components.push(component);
+        return component;
+    }
+    getComponent(Ctor) {
+        for (const c of this._components) {
+            if (c instanceof Ctor)
+                return c;
+        }
+        return null;
+    }
+    getComponents() {
+        return this._components;
+    }
+    removeComponent(component) {
+        const idx = this._components.indexOf(component);
+        if (idx !== -1) {
+            this._components.splice(idx, 1);
+            if (component.onDestroy)
+                component.onDestroy();
+        }
+    }
+}
+/** Reset ID counter (for testing only) */
+export function resetGameObjectIds() {
+    nextId = 1;
+}
+//# sourceMappingURL=game-object.js.map

package/dist/game-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-object.js","sourceRoot":"","sources":["../src/game-object.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,IAAI,MAAM,GAAG,CAAC,CAAC;AAEf,MAAM,OAAO,UAAU;IACZ,EAAE,CAAS;IACX,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IACrC,IAAI,CAAS;IACb,8EAA8E;IAC9E,SAAS,GAAG,KAAK,CAAC;IAED,WAAW,GAAgB,EAAE,CAAC;IACvC,OAAO,GAAsB,IAAI,CAAC;IACzB,SAAS,GAAiB,EAAE,CAAC;IAE9C,YAAY,IAAI,GAAG,YAAY;QAC7B,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,SAAS,CAAC,MAAyB;QACjC,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM;YAAE,OAAO;QACpC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,GAAG,KAAK,CAAC,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7D,CAAC;IAED,YAAY,CAAsB,IAAiB;QACjD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,YAAY,CAAsB,IAAiC;QACjE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACjC,IAAI,CAAC,YAAY,IAAI;gBAAE,OAAO,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,eAAe,CAAC,SAAoB;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAChC,IAAI,SAAS,CAAC,SAAS;gBAAE,SAAS,CAAC,SAAS,EAAE,CAAC;QACjD,CAAC;IACH,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,UAAU,kBAAkB;IAChC,MAAM,GAAG,CAAC,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { Component } from './component.js';
+export { GameObject, resetGameObjectIds } from './game-object.js';
+export { Transform } from './transform.js';
+export { Scene } from './scene.js';
+export type { SceneLoader } from './scene.js';
+export { Time } from './time.js';
+export { Input } from './input.js';
+export { Engine } from './engine.js';
+export type { Renderer, PhysicsStepper } from './engine.js';
+export { registerComponent, getComponentDef, getAllRegisteredComponents, clearRegistry, } from './component-registry.js';
+export type { PropertyDef, PropertyDefBase, PropertyType, ComponentDef, NumberPropertyDef, Vec3PropertyDef, QuatPropertyDef, ColorPropertyDef, EnumPropertyDef, StringPropertyDef, BooleanPropertyDef, GameObjectRefPropertyDef, MaterialAssetPropertyDef, } from './component-registry.js';
+export { registerCoreBuiltins } from './register-builtins.js';
+export { serializeScene, deserializeScene, applyComponentData, serializePostProcess, applyPostProcess } from './scene-serializer.js';
+export type { SceneData, GameObjectData, ComponentData, DeserializeContext, PostProcessData } from './scene-serializer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,WAAW,EACX,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrI,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { Component } from './component.js';
+export { GameObject, resetGameObjectIds } from './game-object.js';
+export { Transform } from './transform.js';
+export { Scene } from './scene.js';
+export { Time } from './time.js';
+export { Input } from './input.js';
+export { Engine } from './engine.js';
+export { registerComponent, getComponentDef, getAllRegisteredComponents, clearRegistry, } from './component-registry.js';
+export { registerCoreBuiltins } from './register-builtins.js';
+export { serializeScene, deserializeScene, applyComponentData, serializePostProcess, applyPostProcess } from './scene-serializer.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,aAAa,GACd,MAAM,yBAAyB,CAAC;AAgBjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,48 @@
+export interface EventTarget {
+    addEventListener: (type: string, handler: (e: unknown) => void, options?: boolean | AddEventListenerOptions) => void;
+    removeEventListener: (type: string, handler: (e: unknown) => void, options?: boolean | EventListenerOptions) => void;
+}
+export interface CanvasLike {
+    getBoundingClientRect(): {
+        left: number;
+        top: number;
+    };
+    addEventListener: (type: string, handler: (e: unknown) => void) => void;
+    removeEventListener: (type: string, handler: (e: unknown) => void) => void;
+}
+export declare class Input {
+    /** The currently active Input instance, set automatically by Engine. */
+    static current: Input | null;
+    private readonly _keysDown;
+    private readonly _keysJustDown;
+    private readonly _keysJustUp;
+    private _mouseButtons;
+    private _detach;
+    /** Canvas-relative mouse position in CSS pixels. Updated on mousemove. */
+    readonly mousePosition: {
+        x: number;
+        y: number;
+    };
+    /** Accumulated mouse movement since last endFrame(). */
+    readonly mouseDelta: {
+        x: number;
+        y: number;
+    };
+    /** Bind keyboard + mouse listeners to a target (e.g., window). Optionally bind mouse position to a canvas. */
+    attach(target: EventTarget, canvas?: CanvasLike): () => void;
+    /** Remove previously attached listeners */
+    detach(): void;
+    /** True while key is held */
+    getKey(code: string): boolean;
+    /** True only on the frame the key was first pressed */
+    getKeyDown(code: string): boolean;
+    /** True only on the frame the key was first pressed (alias for getKeyDown). */
+    getKeyPressed(code: string): boolean;
+    /** True only on the frame the key was released */
+    getKeyUp(code: string): boolean;
+    /** True while mouse button is held (0=left, 1=middle, 2=right). */
+    getMouseButton(button: number): boolean;
+    /** Call at the end of each frame to reset per-frame state */
+    endFrame(): void;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,KAAK,IAAI,CAAC;IACrH,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,KAAK,IAAI,CAAC;CACtH;AAED,MAAM,WAAW,UAAU;IACzB,qBAAqB,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;IACxE,mBAAmB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;CAC5E;AAED,qBAAa,KAAK;IAChB,wEAAwE;IACxE,MAAM,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAQ;IAEpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAA6B;IAE5C,0EAA0E;IAC1E,QAAQ,CAAC,aAAa;;;MAAkB;IAExC,wDAAwD;IACxD,QAAQ,CAAC,UAAU;;;MAAkB;IAErC,8GAA8G;IAC9G,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,IAAI;IA+D5D,2CAA2C;IAC3C,MAAM,IAAI,IAAI;IAId,6BAA6B;IAC7B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI7B,uDAAuD;IACvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIjC,+EAA+E;IAC/E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/B,mEAAmE;IACnE,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC,6DAA6D;IAC7D,QAAQ,IAAI,IAAI;CAMjB"}