@needle-tools/engine 2.58.1-pre → 2.58.2-pre

package/lib/vite.config.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vite").UserConfigExport;
+export default _default;

package/lib/vite.config.js

@@ -0,0 +1,26 @@
+// vite.config.ts
+import { resolve } from 'path';
+import { defineConfig } from 'vite';
+// https://vitejs.dev/guide/build.html#library-mode
+export default defineConfig({
+    build: {
+        lib: {
+            entry: resolve(__dirname, 'needle-engine.ts'),
+            name: 'needle-engine',
+            fileName: 'dist/needle-engine',
+        },
+        rollupOptions: {
+        // external: ["@dimforge/rapier3d-compat"]
+        // external: id => {
+        //     // console.log(id);
+        //     let exclude = id.includes("include/");
+        //     if(exclude) {
+        //         console.log("\n> ", id);
+        //         return true;
+        //     }
+        //     return false;
+        // }
+        }
+    }
+});
+//# sourceMappingURL=vite.config.js.map

package/lib/vite.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.config.js","sourceRoot":"","sources":["../../vite.config.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEpC,mDAAmD;AACnD,eAAe,YAAY,CAAC;IACxB,KAAK,EAAE;QACH,GAAG,EAAE;YACD,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,kBAAkB,CAAC;YAC7C,IAAI,EAAE,eAAe;YACrB,QAAQ,EAAE,oBAAoB;SACjC;QACD,aAAa,EAAE;QACX,0CAA0C;QAC1C,oBAAoB;QACpB,0BAA0B;QAC1B,6CAA6C;QAC7C,oBAAoB;QACpB,mCAAmC;QACnC,uBAAuB;QACvB,QAAQ;QACR,oBAAoB;QACpB,IAAI;SACP;KACJ;CACJ,CAAC,CAAC"}

package/package.json

@@ -1,9 +1,9 @@
 {
     "name": "@needle-tools/engine",
-    "version": "2.58.1-pre",
+    "version": "2.58.2-pre",
     "description": "Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development, and can be deployed anywhere. It is flexible, extensible, and collaboration and XR come naturally.",
-    "main": "dist/needle-engine.js",
-    "module": "src/needle-engine.ts",
+    "main": "dist/needle-engine.umd.cjs",
+    "module": "dist/needle-engine.js",
     "type": "module",
     "repository": {
         "type": "git",
@@ -47,12 +47,30 @@
         "peerjs": "1.3.2",
         "simplex-noise": "^4.0.1",
         "stats.js": "^0.17.0",
-        "three": "npm:@needle-tools/three@^0.146.2",
+        "three": "npm:@needle-tools/three@^0.146.3",
         "three-mesh-ui": "^6.4.5",
         "three.quarks": "^0.7.3",
         "uuid": "^9.0.0",
         "websocket-ts": "^1.1.1"
     },
+    "devDependencies": {
+        "@babel/runtime": "^7.16.0",
+        "@luncheon/esbuild-plugin-gzip": "^0.1.0",
+        "@needle-tools/gltf-transform-extensions": "^0.10.5-pre",
+        "@needle-tools/needle-component-compiler": "1.9.3",
+        "@needle-tools/helper": "^0.2.1-pre",
+        "@types/three": "0.146.0",
+        "copy-files-from-to": "^3.3.0",
+        "esbuild": "^0.15.10",
+        "esbuild-node-externals": "^1.5.0",
+        "jsdoc-babel": "^0.5.0",
+        "jsdoc-to-markdown": "^7.1.1",
+        "madge": "^5.0.1",
+        "msdf-bmfont-xml": "^2.7.0",
+        "npm-watch": "^0.11.0",
+        "typescript": "^4.5.5",
+        "vite": "^4.0.4"
+    },
     "watch": {
         "test:circular-imports": {
             "patterns": [
@@ -73,10 +91,6 @@
             "quiet": false
         }
     },
-    "publishConfig": {
-        "access": "public",
-        "registry": "https://registry.npmjs.org"
-    },
     "typings": "lib/needle-engine.d.ts",
     "types": "lib/needle-engine.d.ts"
 }

package/src/engine/debug/debug.ts

@@ -3,13 +3,10 @@ import { showDebugConsole } from "./debug_console";
 import { isLocalNetwork } from "../engine_networking_utils";
 
 export { showDebugConsole }
-
 export { LogType };
 
 export function showBalloonMessage(text: string, logType: LogType = LogType.Log) {
     addLog(logType, text);
-    // addLog(LogType.Error, text);
-    // addLog(LogType.Log, text);
 }
 
 export function showBalloonWarning(text: string) {

package/src/engine/debug/debug_overlay.ts

@@ -1,11 +1,13 @@
 import { getParam } from "../engine_utils";
 import { isLocalNetwork } from "../engine_networking_utils";
-import { Context } from "../engine_setup";
-import { arContainerClassName } from "../engine_element_overlay";
+import { ContextRegistry } from "../engine_context_registry";
+
+
 
 const debug = getParam("debugdebug");
 const hide = getParam("noerrors");
 
+const arContainerClassName = "ar";
 const errorContainer: Map<HTMLElement, HTMLElement> = new Map();
 const locationRegex = new RegExp("    at .+\/(.+?\.ts)", "g");
 
@@ -52,7 +54,7 @@ function onReceivedError(){
 
 export function addLog(type: LogType, message: string | any[], _file?: string | null, _line?: number | null) {
     if(hide) return;
-    const context = Context.Current;
+    const context = ContextRegistry.Current;
     const domElement = context?.domElement ?? document.querySelector("needle-engine");
     if (!domElement) return;
     if (Array.isArray(message)) {

package/src/engine/debug/index.ts

@@ -0,0 +1 @@
+export * from "./debug";

package/src/engine/engine_addressables.ts

@@ -4,7 +4,7 @@ import { SerializationContext, TypeSerializer } from "./engine_serialization_cor
 import { Context } from "./engine_setup";
 import { Group, Object3D, Scene } from "three";
 import { processNewScripts } from "./engine_mainloop_utils";
-import { InstantiateEvent, registerPrefabProvider, syncInstantiate } from "./engine_networking_instantiate";
+import { registerPrefabProvider, syncInstantiate } from "./engine_networking_instantiate";
 import { download, hash } from "./engine_web_api";
 import { getLoader } from "./engine_gltf";
 import { SourceIdentifier } from "./engine_types";

package/src/engine/engine_context_registry.ts

@@ -0,0 +1,50 @@
+import { IContext } from "./engine_types";
+
+export enum ContextEvent {
+    ContextCreated = "ContextCreated",
+    ContextDestroyed = "ContextDestroyed",
+    MissingCamera = "MissingCamera",
+}
+
+export type ContextEventArgs = {
+    event: ContextEvent;
+    context: IContext;
+}
+
+export type ContextCallback = (evt: ContextEventArgs) => void;
+
+export class ContextRegistry {
+    static Current: IContext;
+
+    static Registered: IContext[] = [];
+
+    static register(ctx: IContext) {
+        this.Registered.push(ctx);
+    }
+
+    static unregister(ctx: IContext) {
+        const index = this.Registered.indexOf(ctx);
+        if (index === -1) return;
+        this.Registered.splice(index, 1);
+    }
+
+    private static _callbacks: { [evt: string]: Array<ContextCallback> } = {};
+
+    static registerCallback(evt: ContextEvent, callback: ContextCallback) {
+        if (!this._callbacks[evt]) this._callbacks[evt] = [];
+        this._callbacks[evt].push(callback);
+    }
+
+    static unregisterCallback(evt: ContextEvent, callback: ContextCallback) {
+        if (!this._callbacks[evt]) return;
+        const index = this._callbacks[evt].indexOf(callback);
+        if (index === -1) return;
+        this._callbacks[evt].splice(index, 1);
+    }
+
+    static dispatchCallback(evt: ContextEvent, context:IContext) {
+        if (!this._callbacks[evt]) return;
+        const args = { event: evt, context }
+        this._callbacks[evt].forEach(cb => cb(args));
+    }
+}

package/src/engine/engine_hot_reload.ts

@@ -93,8 +93,9 @@ export function applyChanges(newModule): boolean {
                 continue;
             }
             const newType = newModule[key];
+            const instancesOfType = instances.get(newType.name);
 
-            console.log("[Needle Engine] Updating type: " + key);
+            console.log("[Needle Engine] Updating type: " + key + " [" + instancesOfType?.length + "]");
 
             // Update prototype (methods and properties)
             const previousMethods = Object.getOwnPropertyNames(typeToUpdate.prototype);
@@ -113,7 +114,6 @@ export function applyChanges(newModule): boolean {
 
             // Update fields (we only add new fields if they are undefined)
             // we create a instance to get access to the fields
-            const instancesOfType = instances.get(newType.name);
             if (instancesOfType) {
                 const newTypeInstance = new newType();
                 const keys = Object.getOwnPropertyDescriptors(newTypeInstance);

package/src/engine/engine_loaders.ts

@@ -7,6 +7,9 @@ import { getParam } from "./engine_utils";
 
 const debug = getParam("debugdecoders");
 
+const DEFAULT_DRACO_DECODER_LOCATION ='https://www.gstatic.com/draco/versioned/decoders/1.4.1/';
+const DEFAULT_KTX2_TRANSCODER_LOCATION ='https://www.gstatic.com/basis-universal/versioned/2021-04-15-ba1c3e4/';
+
 let dracoLoader: DRACOLoader;
 let ktx2Loader: KTX2Loader;
 
@@ -40,14 +43,14 @@ export function setKtx2TranscoderPath(path: string) {
 export function addDracoAndKTX2Loaders(loader: GLTFLoader, context: Context) {
     if (!dracoLoader) {
         dracoLoader = new DRACOLoader();
-        dracoLoader.setDecoderPath('./include/draco/');
+        dracoLoader.setDecoderPath(DEFAULT_DRACO_DECODER_LOCATION);
         dracoLoader.setDecoderConfig({ type: 'js' });
-        if(debug) console.log("Setting draco decoder path to", './include/draco/');
+        if (debug) console.log("Setting draco decoder path to", DEFAULT_DRACO_DECODER_LOCATION);
     }
     if (!ktx2Loader) {
         ktx2Loader = new KTX2Loader();
-        ktx2Loader.setTranscoderPath('./include/ktx2/');
-        if(debug) console.log("Setting ktx2 transcoder path to", './include/ktx2/');
+        ktx2Loader.setTranscoderPath(DEFAULT_KTX2_TRANSCODER_LOCATION);
+        if (debug) console.log("Setting ktx2 transcoder path to", DEFAULT_KTX2_TRANSCODER_LOCATION);
         if (context.renderer)
             ktx2Loader.detectSupport(context.renderer);
     }

package/src/engine/engine_mainloop_utils.ts

@@ -1,10 +1,10 @@
-import { Context } from './engine_setup';
 import * as utils from "./engine_generic_utils";
 import * as constants from "./engine_constants";
 import { getParam } from './engine_utils';
 import { CubeCamera, Object3D, WebGLCubeRenderTarget } from 'three';
-import { IComponent } from './engine_types';
-import { isActiveSelf, setActive } from './engine_gameobject';
+import { IComponent, IContext } from './engine_types';
+import { isActiveSelf } from './engine_gameobject';
+import { ContextRegistry } from "./engine_context_registry";
 
 const debug = getParam("debugnewscripts");
 
@@ -13,7 +13,7 @@ const debug = getParam("debugnewscripts");
 // so we use this copy buffer
 const new_scripts_buffer: any[] = [];
 
-export function processNewScripts(context: Context) {
+export function processNewScripts(context: IContext) {
     if (context.new_scripts.length <= 0) return;
     if (debug)
         console.log("Register new components", context.new_scripts.length, context.alias ? ("element: " + context.alias) : "");
@@ -153,7 +153,7 @@ export function processRemoveFromScene(script: IComponent) {
     removeScriptFromContext(script, script.context);
 }
 
-export function processStart(context: Context, object?: Object3D) {
+export function processStart(context: IContext, object?: Object3D) {
     // Call start on scripts
     for (let i = 0; i < context.new_script_start.length; i++) {
         try {
@@ -182,7 +182,7 @@ export function processStart(context: Context, object?: Object3D) {
 }
 
 
-export function addScriptToArrays(script: any, context: Context) {
+export function addScriptToArrays(script: any, context: IContext) {
     // TODO: not sure if this is ideal - maybe we should add a map if we have many scripts?
     const index = context.scripts.indexOf(script);
     if (index !== -1) return;
@@ -196,7 +196,7 @@ export function addScriptToArrays(script: any, context: Context) {
 }
 
 
-export function removeScriptFromContext(script: any, context: Context) {
+export function removeScriptFromContext(script: any, context: IContext) {
     removeFromArray(script, context.new_scripts);
     removeFromArray(script, context.new_script_start);
     removeFromArray(script, context.scripts);
@@ -218,7 +218,7 @@ const previousActiveMap: { [key: string]: boolean } = {};
 const previousActiveInHierarchyMap: { [key: string]: boolean } = {};
 
 export function updateIsActive(obj?: Object3D) {
-    if (!obj) obj = Context.Current.scene;
+    if (!obj) obj = ContextRegistry.Current.scene;
     if (!obj) {
         console.trace("Invalid call - no current context.");
         return;
@@ -325,12 +325,12 @@ function perComponent(go: THREE.Object3D, evt: (comp: IComponent) => void) {
 }
 
 
-const prewarmList: Map<Context, Object3D[]> = new Map();
+const prewarmList: Map<IContext, Object3D[]> = new Map();
 const $prewarmedFlag = Symbol("prewarmFlag");
 const $waitingForPrewarm = Symbol("waitingForPrewarm");
 const debugPrewarm = getParam("debugprewarm");
 
-export function registerPrewarmObject(obj: Object3D, context: Context) {
+export function registerPrewarmObject(obj: Object3D, context: IContext) {
     if (!obj) return;
     // allow objects to be marked as prewarmed in which case we dont need to register them again
     if (obj[$prewarmedFlag] === true) return;
@@ -348,7 +348,7 @@ let prewarmTarget: WebGLCubeRenderTarget | null = null;
 let prewarmCamera: CubeCamera | null = null;
 
 // called by the engine to remove scroll or animation hiccup when objects are rendered/compiled for the first time
-export function runPrewarm(context: Context) {
+export function runPrewarm(context: IContext) {
     if (!context) return;
     const list = prewarmList.get(context);
     if (!list?.length) return;
@@ -371,7 +371,7 @@ export function runPrewarm(context: Context) {
     }
 }
 
-export function clearPrewarmList(context: Context) {
+export function clearPrewarmList(context: IContext) {
     const list = prewarmList.get(context);
     if (list) {
         for (const obj of list) {

package/src/engine/engine_networking.ts

@@ -631,45 +631,4 @@ export class NetworkConnection implements INetworkConnection {
     }
 
 
-    // GECKOS IO ------------------------------------------------------------
-
-    // private channel!: ClientChannel;
-
-    // private sendGeckosIo(key: string, data: MessageData) {
-    //     this.channel.emit(key, data);
-    // }
-
-    // private onConnectGeckosIo(err) {
-    //     if (err) {
-    //         console.error(err);
-    //         return;
-    //     }
-    //     const self = this;
-    //     const { id: _channelId, maxMessageSize } = this.channel;
-    //     this.channelId = _channelId;
-    //     this.connected = true;
-    //     console.log("Connected to", this.channelId);
-
-    //     this.channel.onDisconnect(() => {
-    //         console.log("Disconnected from", this.channelId);
-    //         this.connected = false;
-    //         this.connect();
-    //     })
-
-    //     this.channel.emit('chat message', "Hello everyone, I'm " + this.channel.id + " from three");
-
-    //     this.channel.on('chat message', function (data) {
-    //         console.log(data);
-    //         // channel.emit('chat message', "three received " + data);
-    //     })
-
-    //     this.channel.on('transform update', function (data) {
-    //         console.log(data);
-    //         for (let i = 0; i < self._listeners['transform update'].length; i++) {
-    //             self._listeners['transform update'][i](data);
-    //         }
-    //         // channel.emit('chat message', "three received " + data);
-    //     });
-    // }
-
 }

package/src/engine/engine_networking_files.ts

@@ -10,6 +10,7 @@ import { getLoader } from "../engine/engine_gltf";
 import { IModel } from "./engine_networking_types";
 import { IGameObject } from "./engine_types";
 import { findByGuid } from "./engine_gameobject";
+import { ContextEvent, ContextRegistry } from "./engine_context_registry";
 
 export enum File_Event {
     File_Spawned = "file-spawned",
@@ -97,6 +98,12 @@ export async function addFileFromUrl(url: URL, context: Context): Promise<GLTF |
     });
 }
 
+
+ContextRegistry.registerCallback(ContextEvent.ContextCreated, evt => {
+    beginListenFileSpawn(evt.context as Context);
+})
+
+
 export function beginListenFileSpawn(context: Context) {
     context.connection.beginListen(File_Event.File_Spawned, async (evt: FileSpawnModel) => {
         if (evt.sender !== context.connection.connectionId) {

package/src/engine/engine_networking_instantiate.ts

@@ -14,10 +14,19 @@ import { SendQueue } from "./engine_networking_types";
 import { destroy, findByGuid, instantiate } from "./engine_gameobject";
 import { Object3D } from "three";
 import { InstantiateOptions } from "./engine_gameobject";
+import { ContextEvent, ContextRegistry } from "../engine/engine_context_registry";
 
 
-const debug = utils.getParam("debugcomponents");
 
+ContextRegistry.registerCallback(ContextEvent.ContextCreated, evt => {
+    const context = evt.context as Context;
+    beginListenInstantiate(context);
+    beginListenDestroy(context);
+});
+
+
+
+const debug = utils.getParam("debugcomponents");
 
 
 const ID_NAMESPACE = 'eff8ba80-635d-11ec-90d6-0242ac120003';

package/src/engine/engine_serialization_core.ts

@@ -3,9 +3,9 @@ import { getParam } from "./engine_utils";
 import { Object3D } from "three";
 import { Context } from "./engine_setup";
 import { isPersistentAsset } from "./extensions/NEEDLE_persistent_assets";
-import { IComponent, SourceIdentifier } from "./engine_types";
+import { SourceIdentifier } from "./engine_types";
 import { debugExtension } from "../engine/engine_default_parameters";
-import { LogType, showBalloonMessage, showBalloonWarning } from "./debug/debug";
+import { LogType, addLog } from "./debug/debug_overlay";
 import { isLocalNetwork } from "./engine_networking_utils";
 import { $BuiltInTypeFlag } from "./engine_typestore";
 
@@ -370,6 +370,7 @@ function checkObjectAssignments(obj: any, serializedData: any, implementationInf
     for (const key of ownKeys) {
         if (key === "sourceId") continue;
         const value = obj[key];
+        if(value == null) continue;
         const serialized = serializedData[key];
         // check if the field is defined in the class
         if (implementationInformation?.getDefinedKey(typeName, key) === false) {
@@ -378,7 +379,7 @@ function checkObjectAssignments(obj: any, serializedData: any, implementationInf
             // because all fields are serialized in lowercase
             const firstCharUppercase = key.charAt(0).toUpperCase() + key.slice(1);
             if (implementationInformation.getDefinedKey(typeName, firstCharUppercase)) {
-                showBalloonWarning("<strong>Please rename</strong> \"" + firstCharUppercase + "\" to \"" + key + "\" in " + typeName);
+                addLog(LogType.Warn, "<strong>Please rename</strong> \"" + firstCharUppercase + "\" to \"" + key + "\" in " + typeName);
                 console.warn("Please use lowercase for field: \"" + firstCharUppercase + "\" in " + typeName, serialized, obj);
             }
 
@@ -393,7 +394,7 @@ function checkObjectAssignments(obj: any, serializedData: any, implementationInf
                     }
                     const hasOtherKeys = value !== undefined && Object.keys(value).length > 1;
                     if (!hasOtherKeys) {
-                        showBalloonMessage(`<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(Object3D)\n${key}? : Object3D;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`, LogType.Warn);
+                        addLog(LogType.Warn, `<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(Object3D)\n${key}? : Object3D;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`);
                         console.warn(typeName, key, obj[key], obj);
                         continue;
                     }
@@ -402,7 +403,7 @@ function checkObjectAssignments(obj: any, serializedData: any, implementationInf
         }
         if (typeof value === "string") {
             if (serialized.endsWith(".gltf") || serialized.endsWith(".glb")) {
-                showBalloonMessage(`<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(AssetReference)\n${key}? : AssetReference;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`, LogType.Warn);
+                addLog(LogType.Warn, `<strong>Missing serialization for object reference!</strong>\n\nPlease change to: \n@serializable(AssetReference)\n${key}? : AssetReference;\n\nin script ${typeName}.ts\n<a href="https://docs.needle.tools/serializable" target="_blank">documentation</a>`);
                 console.warn(typeName, key, obj[key], obj);
                 continue;
             }

package/src/engine/engine_setup.ts

@@ -4,7 +4,6 @@ import { Input } from './engine_input';
 import { Physics } from './engine_physics';
 import { Time } from './engine_time';
 import { NetworkConnection } from './engine_networking';
-import { beginListenDestroy, beginListenInstantiate } from './engine_networking_instantiate';
 
 import * as looputils from './engine_mainloop_utils';
 import * as utils from "./engine_utils";
@@ -12,7 +11,6 @@ import * as utils from "./engine_utils";
 import { EffectComposer } from 'three/examples/jsm/postprocessing/EffectComposer.js';
 import { RenderPass } from 'three/examples/jsm/postprocessing/RenderPass';
 
-import { beginListenFileSpawn } from './engine_networking_files';
 import { AssetDatabase } from './engine_assetdatabase';
 
 import { logHierarchy } from './engine_three_utils';
@@ -24,9 +22,10 @@ import { Application } from './engine_application';
 import { LightDataRegistry, ILightDataRegistry } from './engine_lightdata';
 import { PlayerViewManager } from './engine_playerview';
 
-import { ICamera, IComponent, ILight } from "./engine_types"
+import { CoroutineData, ICamera, IComponent, IContext, ILight } from "./engine_types"
 import { destroy, foreachComponent } from './engine_gameobject';
-import { createCameraWithOrbitControl } from '../engine-components/CameraUtils';
+import { ContextEvent, ContextRegistry } from './engine_context_registry';
+// import { createCameraWithOrbitControl } from '../engine-components/CameraUtils';
 
 
 const debug = utils.getParam("debugSetup");
@@ -38,12 +37,6 @@ const debugActive = utils.getParam("debugactive");
 // those will be accessed from our custom html element to load them into their context
 export const build_scene_functions: { [name: string]: (context: Context) => Promise<void> } = {};
 
-declare type CoroutineData = {
-	comp: IComponent,
-	main: Generator,
-	chained?: Array<Generator>
-}
-
 export declare class LoadingProgressArgs {
 	name: string;
 	progress: ProgressEvent;
@@ -92,7 +85,7 @@ export function registerComponent(script: IComponent, context?: Context) {
 	}
 }
 
-export class Context {
+export class Context implements IContext {
 
 	private static _current: Context;
 
@@ -101,6 +94,7 @@ export class Context {
 	}
 
 	static set Current(context: Context) {
+		ContextRegistry.Current = context;
 		this._current = context;
 	}
 
@@ -272,6 +266,8 @@ export class Context {
 
 		this.scene = new THREE.Scene();
 
+		ContextRegistry.register(this);
+
 		this.application = new Application(this);
 		this.time = new Time();
 		this.input = new Input(this);
@@ -362,6 +358,9 @@ export class Context {
 		if (this.domElement?.parentElement) {
 			this.domElement.parentElement.removeChild(this.domElement);
 		}
+
+		ContextRegistry.dispatchCallback(ContextEvent.ContextDestroyed, this);
+		ContextRegistry.unregister(this);
 	}
 
 	registerCoroutineUpdate(script: IComponent, coroutine: Generator, evt: FrameEvent): Generator {
@@ -480,6 +479,7 @@ export class Context {
 		return style.visibility !== "hidden" && style.display !== "none" && style.opacity !== "0";
 	}
 
+
 	private async internalOnCreate(buildScene?: (context: Context, opts?: LoadingOptions) => Promise<void>, opts?: LoadingOptions) {
 
 		// TODO: we could configure if we need physics
@@ -503,9 +503,8 @@ export class Context {
 		if (!this.isManagedExternally)
 			this.domElement.prepend(this.renderer.domElement);
 
-		beginListenInstantiate(this);
-		beginListenDestroy(this);
-		beginListenFileSpawn(this);
+		Context._current = this;
+		ContextRegistry.dispatchCallback(ContextEvent.ContextCreated, this);
 
 		// Setup
 		Context._current = this;
@@ -560,8 +559,9 @@ export class Context {
 				this.setCurrentCamera(camera);
 			}
 			else {
-				console.error("MISSING camera", this);
-				createCameraWithOrbitControl(this.scene, "unknown");
+				ContextRegistry.dispatchCallback(ContextEvent.MissingCamera, this);
+				if (!this.mainCamera)
+					console.error("MISSING camera", this);
 			}
 		}
 
@@ -605,7 +605,7 @@ export class Context {
 		this.time.update();
 
 		looputils.processNewScripts(this);
-		looputils.updateIsActive();
+		looputils.updateIsActive(this.scene);
 		looputils.processStart(this);
 
 		while (this._cameraStack.length > 0 && (!this.mainCameraComponent || this.mainCameraComponent.destroyed)) {

package/src/engine/engine_types.ts

@@ -1,7 +1,6 @@
-import { Camera, Color, Material, Object3D, Vector3, Quaternion, Ray } from "three";
+import { Camera, Color, Material, Object3D, Vector3, Quaternion, Ray, Scene, Renderer, WebGLRenderer } from "three";
 import { RGBAColor } from "../engine-components/js-extensions/RGBAColor";
 import { CollisionDetectionMode, PhysicsMaterial, RigidbodyConstraints } from "./engine_physics.types";
-import { getWorldPosition } from "./engine_three_utils";
 import { CircularBuffer } from "./engine_utils";
 
 /** used to find data registered via gltf files e.g. find lightmaps for a Renderer component that were shipped inside a gltf */
@@ -20,6 +19,47 @@ export interface UIDProvider {
     generateUUID(): string;
 }
 
+
+export declare type CoroutineData = {
+	comp: IComponent,
+	main: Generator,
+	chained?: Array<Generator>
+}
+
+
+export interface IContext {
+    alias?: string | null;
+
+    scene : Scene;
+    renderer : WebGLRenderer;
+    mainCamera : Camera | null;
+    domElement : HTMLElement;
+
+    scripts: IComponent[];
+	scripts_pausedChanged: IComponent[];
+	// scripts with update event
+	scripts_earlyUpdate: IComponent[];
+	scripts_update: IComponent[];
+	scripts_lateUpdate: IComponent[];
+	scripts_onBeforeRender: IComponent[];
+	scripts_onAfterRender: IComponent[];
+	scripts_WithCorroutines: IComponent[];
+	coroutines: { [FrameEvent: number]: Array<CoroutineData> };
+    
+	post_setup_callbacks: Function[];
+	pre_update_callbacks: Function[];
+	pre_render_callbacks: Function[];
+	post_render_callbacks: Function[];
+
+	new_scripts: IComponent[];
+	new_script_start: IComponent[];
+	new_scripts_pre_setup_callbacks: Function[];
+	new_scripts_post_setup_callbacks: Function[];
+
+    stopAllCoroutinesFrom(script: IComponent);
+}
+
+
 export declare interface INeedleEngineComponent extends HTMLElement {
     getAROverlayContainer(): HTMLElement;
     onEnterAR(session: XRSession, overlayContainer: HTMLElement);
@@ -150,7 +190,7 @@ export declare interface IRigidbody extends IComponent {
     drag: number;
     angularDrag: number;
     useGravity: boolean;
-    gravityScale : number;
+    gravityScale: number;
     collisionDetectionMode: CollisionDetectionMode;
 
     lockPositionX: boolean;