@certe/atmos-core 0.1.0

package/dist/input.js

@@ -0,0 +1,102 @@
+export class Input {
+    /** The currently active Input instance, set automatically by Engine. */
+    static current = null;
+    _keysDown = new Set();
+    _keysJustDown = new Set();
+    _keysJustUp = new Set();
+    _mouseButtons = 0;
+    _detach = null;
+    /** Canvas-relative mouse position in CSS pixels. Updated on mousemove. */
+    mousePosition = { x: 0, y: 0 };
+    /** Accumulated mouse movement since last endFrame(). */
+    mouseDelta = { x: 0, y: 0 };
+    /** Bind keyboard + mouse listeners to a target (e.g., window). Optionally bind mouse position to a canvas. */
+    attach(target, canvas) {
+        this.detach();
+        const onKeyDown = (e) => {
+            const key = e.code;
+            if (!this._keysDown.has(key)) {
+                this._keysJustDown.add(key);
+            }
+            this._keysDown.add(key);
+        };
+        const onKeyUp = (e) => {
+            const key = e.code;
+            this._keysDown.delete(key);
+            this._keysJustUp.add(key);
+        };
+        const onMouseMove = (e) => {
+            const me = e;
+            this.mouseDelta.x += me.movementX;
+            this.mouseDelta.y += me.movementY;
+            this._mouseButtons = me.buttons;
+        };
+        const onMouseDown = (e) => {
+            this._mouseButtons = e.buttons;
+        };
+        const onMouseUp = (e) => {
+            this._mouseButtons = e.buttons;
+        };
+        // Use capture phase so events are received before any focused element
+        // (e.g. <select>) can consume or stop propagation of keyboard events.
+        target.addEventListener('keydown', onKeyDown, true);
+        target.addEventListener('keyup', onKeyUp, true);
+        target.addEventListener('mousemove', onMouseMove);
+        target.addEventListener('mousedown', onMouseDown);
+        target.addEventListener('mouseup', onMouseUp);
+        let onCanvasMouseMove = null;
+        if (canvas) {
+            onCanvasMouseMove = (e) => {
+                const me = e;
+                const rect = canvas.getBoundingClientRect();
+                this.mousePosition.x = me.clientX - rect.left;
+                this.mousePosition.y = me.clientY - rect.top;
+            };
+            canvas.addEventListener('mousemove', onCanvasMouseMove);
+        }
+        this._detach = () => {
+            target.removeEventListener('keydown', onKeyDown, true);
+            target.removeEventListener('keyup', onKeyUp, true);
+            target.removeEventListener('mousemove', onMouseMove);
+            target.removeEventListener('mousedown', onMouseDown);
+            target.removeEventListener('mouseup', onMouseUp);
+            if (canvas && onCanvasMouseMove) {
+                canvas.removeEventListener('mousemove', onCanvasMouseMove);
+            }
+            this._detach = null;
+        };
+        return this._detach;
+    }
+    /** Remove previously attached listeners */
+    detach() {
+        this._detach?.();
+    }
+    /** True while key is held */
+    getKey(code) {
+        return this._keysDown.has(code);
+    }
+    /** True only on the frame the key was first pressed */
+    getKeyDown(code) {
+        return this._keysJustDown.has(code);
+    }
+    /** True only on the frame the key was first pressed (alias for getKeyDown). */
+    getKeyPressed(code) {
+        return this._keysJustDown.has(code);
+    }
+    /** True only on the frame the key was released */
+    getKeyUp(code) {
+        return this._keysJustUp.has(code);
+    }
+    /** True while mouse button is held (0=left, 1=middle, 2=right). */
+    getMouseButton(button) {
+        return (this._mouseButtons & (1 << button)) !== 0;
+    }
+    /** Call at the end of each frame to reset per-frame state */
+    endFrame() {
+        this._keysJustDown.clear();
+        this._keysJustUp.clear();
+        this.mouseDelta.x = 0;
+        this.mouseDelta.y = 0;
+    }
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

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

package/dist/register-builtins.d.ts

@@ -0,0 +1,2 @@
+export declare function registerCoreBuiltins(): void;
+//# sourceMappingURL=register-builtins.d.ts.map

package/dist/register-builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-builtins.d.ts","sourceRoot":"","sources":["../src/register-builtins.ts"],"names":[],"mappings":"AAGA,wBAAgB,oBAAoB,IAAI,IAAI,CAS3C"}

package/dist/register-builtins.js

@@ -0,0 +1,13 @@
+import { registerComponent } from './component-registry.js';
+import { Transform } from './transform.js';
+export function registerCoreBuiltins() {
+    registerComponent(Transform, {
+        name: 'Transform',
+        properties: [
+            { key: 'position', type: 'vec3' },
+            { key: 'rotation', type: 'quat' },
+            { key: 'scale', type: 'vec3' },
+        ],
+    });
+}
+//# sourceMappingURL=register-builtins.js.map

package/dist/register-builtins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-builtins.js","sourceRoot":"","sources":["../src/register-builtins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,UAAU,oBAAoB;IAClC,iBAAiB,CAAC,SAAS,EAAE;QAC3B,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE;YACV,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;YACjC,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;YACjC,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE;SAC/B;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/scene-serializer.d.ts

@@ -0,0 +1,46 @@
+import { Scene } from './scene.js';
+import { GameObject } from './game-object.js';
+export interface ComponentData {
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface GameObjectData {
+    name: string;
+    id: number;
+    parentId: number | null;
+    /** @deprecated Use parentId instead */
+    parentName?: string | null;
+    components: ComponentData[];
+}
+export interface PostProcessData {
+    bloomIntensity?: number;
+    bloomThreshold?: number;
+    bloomRadius?: number;
+    ssaoEnabled?: boolean;
+    ssaoRadius?: number;
+    ssaoBias?: number;
+    ssaoIntensity?: number;
+    exposure?: number;
+    vignetteIntensity?: number;
+    vignetteRadius?: number;
+    fogEnabled?: boolean;
+    fogMode?: 'linear' | 'exponential';
+    fogDensity?: number;
+    fogStart?: number;
+    fogEnd?: number;
+    fogColor?: number[];
+}
+export interface SceneData {
+    gameObjects: GameObjectData[];
+    postProcess?: PostProcessData;
+}
+export interface DeserializeContext {
+    onComponent?(gameObject: GameObject, type: string, data: Record<string, unknown>): void;
+    onComplete?(): void;
+}
+export declare function serializeScene(scene: Scene): SceneData;
+export declare function applyComponentData(target: unknown, data: Record<string, unknown>): void;
+export declare function deserializeScene(data: SceneData, context?: DeserializeContext): Scene;
+export declare function serializePostProcess(source: Record<string, unknown>): PostProcessData;
+export declare function applyPostProcess(target: Record<string, unknown>, data: PostProcessData): void;
+//# sourceMappingURL=scene-serializer.d.ts.map

package/dist/scene-serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-serializer.d.ts","sourceRoot":"","sources":["../src/scene-serializer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uCAAuC;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxF,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB;AAsBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CA4CtD;AAwBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAIvF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,KAAK,CAyErF;AASD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,CAQrF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAc7F"}

package/dist/scene-serializer.js

@@ -0,0 +1,197 @@
+import { Scene } from './scene.js';
+import { GameObject } from './game-object.js';
+import { Transform } from './transform.js';
+import { getComponentDef, getAllRegisteredComponents } from './component-registry.js';
+function resolvePropertyPath(obj, path) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function toSerializableValue(value) {
+    if (value instanceof Float32Array) {
+        return Array.from(value);
+    }
+    if (value instanceof GameObject) {
+        return value.id;
+    }
+    return value;
+}
+export function serializeScene(scene) {
+    const allComponents = getAllRegisteredComponents();
+    const ctorByName = new Map();
+    for (const [ctor, def] of allComponents) {
+        ctorByName.set(def.name, ctor);
+    }
+    const gameObjects = [];
+    for (const obj of scene.getAllObjects()) {
+        if (obj.transient)
+            continue;
+        const components = [];
+        // Serialize Transform (always present)
+        const transformDef = getComponentDef(Transform);
+        if (transformDef) {
+            const data = {};
+            for (const prop of transformDef.properties) {
+                data[prop.key] = toSerializableValue(resolvePropertyPath(obj.transform, prop.key));
+            }
+            components.push({ type: 'Transform', data });
+        }
+        // Serialize other components
+        for (const comp of obj.getComponents()) {
+            const def = getComponentDef(comp.constructor);
+            if (!def || def.name === 'Transform')
+                continue;
+            const data = {};
+            for (const prop of def.properties) {
+                data[prop.key] = toSerializableValue(resolvePropertyPath(comp, prop.key));
+            }
+            components.push({ type: def.name, data });
+        }
+        gameObjects.push({
+            name: obj.name,
+            id: obj.id,
+            parentId: obj.parent?.id ?? null,
+            components,
+        });
+    }
+    return { gameObjects };
+}
+function setPropertyPath(obj, path, value) {
+    const parts = path.split('.');
+    let current = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (current == null || typeof current !== 'object')
+            return;
+        current = current[parts[i]];
+    }
+    if (current == null || typeof current !== 'object')
+        return;
+    const lastKey = parts[parts.length - 1];
+    const existing = current[lastKey];
+    if (existing instanceof Float32Array && Array.isArray(value)) {
+        for (let i = 0; i < value.length && i < existing.length; i++) {
+            existing[i] = value[i];
+        }
+        // Re-assign to trigger setter (e.g. HingeJoint.axis recreates joint)
+        current[lastKey] = existing;
+    }
+    else {
+        current[lastKey] = value;
+    }
+}
+export function applyComponentData(target, data) {
+    for (const [key, value] of Object.entries(data)) {
+        setPropertyPath(target, key, value);
+    }
+}
+export function deserializeScene(data, context) {
+    const scene = new Scene();
+    const objectsById = new Map();
+    const objectsByName = new Map();
+    // Build name→def lookup for resolving gameObjectRef properties
+    const defByName = new Map();
+    for (const [, def] of getAllRegisteredComponents()) {
+        defByName.set(def.name, def);
+    }
+    // Pass 1: create all game objects + apply transforms
+    for (const objData of data.gameObjects) {
+        const go = new GameObject(objData.name);
+        if (objData.id !== undefined)
+            objectsById.set(objData.id, go);
+        objectsByName.set(objData.name, go);
+        const transformData = objData.components.find((c) => c.type === 'Transform');
+        if (transformData) {
+            const td = transformData.data;
+            if (Array.isArray(td['position'])) {
+                const p = td['position'];
+                go.transform.setPosition(p[0], p[1], p[2]);
+            }
+            if (Array.isArray(td['rotation'])) {
+                const r = td['rotation'];
+                go.transform.setRotation(r[0], r[1], r[2], r[3]);
+            }
+            if (Array.isArray(td['scale'])) {
+                const s = td['scale'];
+                go.transform.setScale(s[0], s[1], s[2]);
+            }
+        }
+    }
+    // Pass 2: create components (all objects exist, so gameObjectRef ids can resolve)
+    for (const objData of data.gameObjects) {
+        const go = objData.id !== undefined ? objectsById.get(objData.id) : objectsByName.get(objData.name);
+        if (!go)
+            continue;
+        for (const compData of objData.components) {
+            if (compData.type === 'Transform')
+                continue;
+            // Resolve gameObjectRef ids → actual GameObjects
+            const def = defByName.get(compData.type);
+            if (def) {
+                for (const prop of def.properties) {
+                    if (prop.type === 'gameObjectRef' && typeof compData.data[prop.key] === 'number') {
+                        compData.data[prop.key] = objectsById.get(compData.data[prop.key]) ?? null;
+                    }
+                }
+            }
+            context?.onComponent?.(go, compData.type, compData.data);
+        }
+    }
+    // Pass 3: set parent-child relationships (prefer id, fallback to name for old format)
+    for (const objData of data.gameObjects) {
+        const go = objData.id !== undefined ? objectsById.get(objData.id) : objectsByName.get(objData.name);
+        if (!go)
+            continue;
+        if (objData.parentId != null) {
+            const parent = objectsById.get(objData.parentId);
+            if (parent)
+                go.setParent(parent);
+        }
+        else if (objData.parentName) {
+            const parent = objectsByName.get(objData.parentName);
+            if (parent)
+                go.setParent(parent);
+        }
+        scene.add(go);
+    }
+    // NOTE: caller is responsible for awaiting context.onComplete() after this returns.
+    return scene;
+}
+const POST_PROCESS_KEYS = [
+    'bloomIntensity', 'bloomThreshold', 'bloomRadius',
+    'ssaoEnabled', 'ssaoRadius', 'ssaoBias', 'ssaoIntensity',
+    'exposure', 'vignetteIntensity', 'vignetteRadius',
+    'fogEnabled', 'fogMode', 'fogDensity', 'fogStart', 'fogEnd', 'fogColor',
+];
+export function serializePostProcess(source) {
+    const result = {};
+    for (const key of POST_PROCESS_KEYS) {
+        const val = source[key];
+        if (val === undefined)
+            continue;
+        result[key] = toSerializableValue(val);
+    }
+    return result;
+}
+export function applyPostProcess(target, data) {
+    for (const key of POST_PROCESS_KEYS) {
+        const val = data[key];
+        if (val === undefined)
+            continue;
+        const existing = target[key];
+        if (existing instanceof Float32Array && Array.isArray(val)) {
+            for (let i = 0; i < val.length && i < existing.length; i++) {
+                existing[i] = val[i];
+            }
+            target[key] = existing;
+        }
+        else {
+            target[key] = val;
+        }
+    }
+}
+//# sourceMappingURL=scene-serializer.js.map

package/dist/scene-serializer.js.map

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

package/dist/scene.d.ts

@@ -0,0 +1,38 @@
+import { GameObject } from './game-object.js';
+export type SceneLoader = (name: string) => void;
+export declare class Scene {
+    /** The currently active scene, set automatically by Engine. */
+    static current: Scene | null;
+    private static _sceneLoader;
+    /** Register a callback that handles scene loading by name. */
+    static setSceneLoader(loader: SceneLoader | null): void;
+    /**
+     * Request loading a scene by name (e.g. 'level2').
+     * The registered loader will handle deserialization and scene swap.
+     */
+    static loadScene(name: string): void;
+    private readonly _roots;
+    private readonly _allObjects;
+    private _started;
+    get roots(): readonly GameObject[];
+    add(gameObject: GameObject): void;
+    remove(gameObject: GameObject): void;
+    /**
+     * Call onDestroy on components, then reset started flag so awakeAll/startAll fire again.
+     * Optional filter: only destroy components where filter returns true.
+     */
+    destroyAllComponents(filter?: (comp: import('./component.js').Component) => boolean): void;
+    awakeAll(): void;
+    startAll(): void;
+    updateAll(dt: number): void;
+    renderAll(): void;
+    /**
+     * Update root tracking for an object already in the scene.
+     * Does NOT destroy components — safe to call during reparenting.
+     */
+    updateRootStatus(gameObject: GameObject): void;
+    getAllObjects(): ReadonlySet<GameObject>;
+    /** Find all components of a given type across the entire scene. */
+    findAll<T extends import('./component.js').Component>(Ctor: new (...args: never[]) => T): T[];
+}
+//# sourceMappingURL=scene.d.ts.map

package/dist/scene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../src/scene.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAEjD,qBAAa,KAAK;IAChB,+DAA+D;IAC/D,MAAM,CAAC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAQ;IAEpC,OAAO,CAAC,MAAM,CAAC,YAAY,CAA4B;IAEvD,8DAA8D;IAC9D,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAIvD;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,QAAQ,CAAS;IAEzB,IAAI,KAAK,IAAI,SAAS,UAAU,EAAE,CAEjC;IAED,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAYjC,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAgBpC;;;OAGG;IACH,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,gBAAgB,EAAE,SAAS,KAAK,OAAO,GAAG,IAAI;IAS1F,QAAQ,IAAI,IAAI;IAQhB,QAAQ,IAAI,IAAI;IAUhB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAQ3B,SAAS,IAAI,IAAI;IAejB;;;OAGG;IACH,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAU9C,aAAa,IAAI,WAAW,CAAC,UAAU,CAAC;IAIxC,mEAAmE;IACnE,OAAO,CAAC,CAAC,SAAS,OAAO,gBAAgB,EAAE,SAAS,EAClD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GAChC,CAAC,EAAE;CAQP"}

package/dist/scene.js

@@ -0,0 +1,142 @@
+import { _setSceneClass } from './component.js';
+export class Scene {
+    /** The currently active scene, set automatically by Engine. */
+    static current = null;
+    static _sceneLoader = null;
+    /** Register a callback that handles scene loading by name. */
+    static setSceneLoader(loader) {
+        Scene._sceneLoader = loader;
+    }
+    /**
+     * Request loading a scene by name (e.g. 'level2').
+     * The registered loader will handle deserialization and scene swap.
+     */
+    static loadScene(name) {
+        if (!Scene._sceneLoader) {
+            console.warn(`[Scene] No scene loader registered, cannot load "${name}"`);
+            return;
+        }
+        Scene._sceneLoader(name);
+    }
+    _roots = [];
+    _allObjects = new Set();
+    _started = false;
+    get roots() {
+        return this._roots;
+    }
+    add(gameObject) {
+        if (this._allObjects.has(gameObject))
+            return;
+        this._allObjects.add(gameObject);
+        if (!gameObject.parent) {
+            this._roots.push(gameObject);
+        }
+        // Recursively add all children
+        for (const child of gameObject.children) {
+            this.add(child);
+        }
+    }
+    remove(gameObject) {
+        if (!this._allObjects.has(gameObject))
+            return;
+        // Recursively remove all children first
+        for (const child of gameObject.children) {
+            this.remove(child);
+        }
+        this._allObjects.delete(gameObject);
+        const idx = this._roots.indexOf(gameObject);
+        if (idx !== -1)
+            this._roots.splice(idx, 1);
+        // Destroy components (always, regardless of enabled state — must free GPU/physics resources)
+        for (const comp of gameObject.getComponents()) {
+            if (comp.onDestroy)
+                comp.onDestroy();
+        }
+    }
+    /**
+     * Call onDestroy on components, then reset started flag so awakeAll/startAll fire again.
+     * Optional filter: only destroy components where filter returns true.
+     */
+    destroyAllComponents(filter) {
+        for (const obj of this._allObjects) {
+            for (const comp of obj.getComponents()) {
+                if (comp.onDestroy && (!filter || filter(comp)))
+                    comp.onDestroy();
+            }
+        }
+        this._started = false;
+    }
+    awakeAll() {
+        for (const obj of this._allObjects) {
+            for (const comp of obj.getComponents()) {
+                if (comp.enabled && comp.onAwake)
+                    comp.onAwake();
+            }
+        }
+    }
+    startAll() {
+        if (this._started)
+            return;
+        this._started = true;
+        for (const obj of this._allObjects) {
+            for (const comp of obj.getComponents()) {
+                if (comp.enabled && comp.onStart)
+                    comp.onStart();
+            }
+        }
+    }
+    updateAll(dt) {
+        for (const obj of this._allObjects) {
+            for (const comp of obj.getComponents()) {
+                if (comp.enabled && comp.onUpdate)
+                    comp.onUpdate(dt);
+            }
+        }
+    }
+    renderAll() {
+        // Update transforms top-down (skip clean hierarchies)
+        for (const root of this._roots) {
+            if (root.transform.isDirty) {
+                root.transform.updateWorldMatrix();
+            }
+        }
+        // Call onRender on all components
+        for (const obj of this._allObjects) {
+            for (const comp of obj.getComponents()) {
+                if (comp.enabled && comp.onRender)
+                    comp.onRender();
+            }
+        }
+    }
+    /**
+     * Update root tracking for an object already in the scene.
+     * Does NOT destroy components — safe to call during reparenting.
+     */
+    updateRootStatus(gameObject) {
+        if (!this._allObjects.has(gameObject))
+            return;
+        const idx = this._roots.indexOf(gameObject);
+        if (!gameObject.parent && idx === -1) {
+            this._roots.push(gameObject);
+        }
+        else if (gameObject.parent && idx !== -1) {
+            this._roots.splice(idx, 1);
+        }
+    }
+    getAllObjects() {
+        return this._allObjects;
+    }
+    /** Find all components of a given type across the entire scene. */
+    findAll(Ctor) {
+        const results = [];
+        for (const obj of this._allObjects) {
+            const comp = obj.getComponent(Ctor);
+            if (comp)
+                results.push(comp);
+        }
+        return results;
+    }
+}
+// Break circular dependency: component.ts needs Scene.current but can't import Scene directly.
+_setSceneClass(Scene);
+//# sourceMappingURL=scene.js.map

package/dist/scene.js.map

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

package/dist/time.d.ts

@@ -0,0 +1,9 @@
+export declare class Time {
+    deltaTime: number;
+    time: number;
+    frameCount: number;
+    private _lastTimestamp;
+    reset(): void;
+    update(timestamp: number): void;
+}
+//# sourceMappingURL=time.d.ts.map

package/dist/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAEA,qBAAa,IAAI;IACf,SAAS,SAAK;IACd,IAAI,SAAK;IACT,UAAU,SAAK;IAEf,OAAO,CAAC,cAAc,CAAK;IAE3B,KAAK,IAAI,IAAI;IAOb,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAUhC"}

package/dist/time.js

@@ -0,0 +1,24 @@
+const MAX_DELTA = 1 / 10; // clamp to 100ms to avoid spiral of death
+export class Time {
+    deltaTime = 0;
+    time = 0;
+    frameCount = 0;
+    _lastTimestamp = 0;
+    reset() {
+        this.deltaTime = 0;
+        this.time = 0;
+        this.frameCount = 0;
+        this._lastTimestamp = 0;
+    }
+    update(timestamp) {
+        if (this._lastTimestamp === 0) {
+            this._lastTimestamp = timestamp;
+        }
+        const rawDelta = (timestamp - this._lastTimestamp) / 1000;
+        this.deltaTime = Math.min(rawDelta, MAX_DELTA);
+        this.time += this.deltaTime;
+        this.frameCount++;
+        this._lastTimestamp = timestamp;
+    }
+}
+//# sourceMappingURL=time.js.map

package/dist/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../src/time.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,0CAA0C;AAEpE,MAAM,OAAO,IAAI;IACf,SAAS,GAAG,CAAC,CAAC;IACd,IAAI,GAAG,CAAC,CAAC;IACT,UAAU,GAAG,CAAC,CAAC;IAEP,cAAc,GAAG,CAAC,CAAC;IAE3B,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,IAAI,IAAI,CAAC,cAAc,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;QAClC,CAAC;QACD,MAAM,QAAQ,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;QAC1D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC;QAC5B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;CACF"}