@needle-tools/engine 3.5.3-alpha.1 → 3.5.5-alpha

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@needle-tools/engine",
-    "version": "3.5.3-alpha.1",
+    "version": "3.5.5-alpha",
     "description": "Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development with great integrations into editors like Unity or Blender - and can be deployed onto any device! It is flexible, extensible and networking and XR are built-in",
     "main": "dist/needle-engine.umd.cjs",
     "type": "module",

package/plugins/vite/copyfiles.js

@@ -1,5 +1,5 @@
 
-import { resolve, join } from 'path'
+import { resolve, join, isAbsolute } from 'path'
 import { existsSync, statSync, mkdirSync, readdirSync, copyFileSync, mkdir } from 'fs';
 import { builtAssetsDirectory, tryLoadProjectConfig } from './config.js';
 
@@ -51,6 +51,30 @@ async function run(isBuild, config) {
         if (!existsSync(outDir)) {
             mkdirSync(outDir);
         }
+
+        // copy a list of files or directories declared in build.copy = [] in the needle.config.json
+        /*
+        "build": {
+            "copy": ["myFolder", "myFile.txt"]
+        }
+        */
+        if (needleConfig?.build?.copy) {
+            const arr = needleConfig.build.copy;
+            for (let i = 0; i < arr.length; i++) {
+                const entry = arr[i];
+                if (Array.isArray(entry)) {
+                    console.log("WARN: build.copy can only contain string paths to copy to. Found array instead.");
+                    continue;
+                }
+                const src = resolve(baseDir, entry);
+                const dest = resolvePath(outDir, entry);
+                if (existsSync(src)) {
+                    console.log(`[${pluginName}] - Copy ${entry} to ${outdirName}/${entry}`)
+                    copyRecursiveSync(src, dest);
+                }
+            }
+        }
+
         // copy assets dir
         const assetsDir = resolve(baseDir, assetsDirName);
         if (existsSync(assetsDir)) {
@@ -68,13 +92,36 @@ async function run(isBuild, config) {
     }
 }
 
+/** resolves relative or absolute paths to a path inside the out directory
+ * for example D:/myFile.txt would resolve to outDir/myFile.txt
+ * wherereas "some/relative/path" would become outDir/some/relative/path
+ */
+function resolvePath(outDir, pathValue) {
+    if (isAbsolute(pathValue)) {
+        var exists = existsSync(pathValue);
+        if (!exists) return null;
+        var stats = exists && statSync(pathValue);
+        if (stats.isDirectory()) {
+            const dirName = pathValue.replaceAll('\\', '/').split('/').pop();
+            return resolve(outDir, dirName);
+        }
+        const fileName = pathValue.replaceAll('\\', '/').split('/').pop();
+        return resolve(outDir, fileName);
+    }
+    return resolve(outDir, pathValue);
+}
+
 function copyRecursiveSync(src, dest) {
+    if (dest === null) {
+        console.log(`[${pluginName}] - Copy ${src} to ${dest} - dest is null`)
+        return;
+    }
     var exists = existsSync(src);
     var stats = exists && statSync(src);
     var isDirectory = exists && stats.isDirectory();
     if (isDirectory) {
         if (!existsSync(dest))
-            mkdirSync(dest);
+            mkdirSync(dest, { recursive: true });
         readdirSync(src).forEach(function (childItemName) {
             copyRecursiveSync(join(src, childItemName), join(dest, childItemName));
         });

package/plugins/vite/defines.js

@@ -1,19 +1,26 @@
 import { loadConfig } from "./config.js";
+import { tryGetNeedleEngineVersion } from "./utils.js";
 
 /** used to pass config variables into vite.config.define
  * for example "useRapier"
  */
-export const needleDefines = (command, config, userSettings) => {
+export const needleDefines = (command, needleEngineConfig, userSettings) => {
 
     if (!userSettings) userSettings = {};
 
     let useRapier = true;
-    if (config.useRapier === false || userSettings?.useRapier === false) useRapier = false;
+    if (needleEngineConfig.useRapier === false || userSettings?.useRapier === false) useRapier = false;
 
     return {
         name: 'needle-defines',
         enforce: 'pre',
-        config(config) {
+        config(viteConfig) {
+            if (!viteConfig.define) viteConfig.define = {};
+            viteConfig.define.NEEDLE_ENGINE_META = {
+                version: tryGetNeedleEngineVersion(),
+                generator: needleEngineConfig.generator,
+            }
+
             if (useRapier && userSettings?.useRapier !== true) {
                 const meta = loadConfig();
                 if (meta?.useRapier === false) {
@@ -21,9 +28,8 @@ export const needleDefines = (command, config, userSettings) => {
                 }
             }
             console.log("UseRapier?", useRapier);
-            if (!config.define) config.define = {};
-            if (config.define.NEEDLE_USE_RAPIER === undefined) {
-                config.define.NEEDLE_USE_RAPIER = useRapier;
+            if (viteConfig.define.NEEDLE_USE_RAPIER === undefined) {
+                viteConfig.define.NEEDLE_USE_RAPIER = useRapier;
             }
         }
     }

package/plugins/vite/license.js

@@ -1,5 +1,6 @@
 import { loadConfig } from './config.js';
 
+let didLog = false;
 
 export const needleLicense = (command, config, userSettings) => {
 
@@ -7,15 +8,27 @@ export const needleLicense = (command, config, userSettings) => {
         name: "needle-license",
         enforce: 'pre',
         async transform(src, id) {
-            const isNeedleEngineFile = id.includes("engine/engine_license") || id.includes("needle-tools_engine.js");
+            const isNeedleEngineFile = id.includes("engine/engine_license") || id.includes("needle-tools_engine");
             // sometimes the actual license parameter is in a unnamed chunk file
             const isViteChunkFile = id.includes("chunk") && id.includes(".vite");
             if (isNeedleEngineFile || isViteChunkFile) {
                 const needleConfig = await loadConfig();
                 if (needleConfig) {
                     if (typeof needleConfig.license === "string") {
-                        src = src.replace("const NEEDLE_ENGINE_LICENSE_TYPE: string = \"\";", "const NEEDLE_ENGINE_LICENSE_TYPE: string = \"" + needleConfig.license + "\";");
-                        return { code: src, map: null }
+                        if (!didLog) {
+                            didLog = true;
+                            console.log("Applying license: " + needleConfig.license);
+                        }
+                        const index = src.indexOf("NEEDLE_ENGINE_LICENSE_TYPE");
+                        if (index >= 0) {
+                            const end = src.indexOf(";", index);
+                            if (end >= 0) {
+                                const line = src.substring(index, end);
+                                const replaced = "NEEDLE_ENGINE_LICENSE_TYPE = \"" + needleConfig.license + "\"";
+                                src = src.replace(line, replaced);
+                                return { code: src, map: null }
+                            }
+                        }
                     }
                 }
                 else {

package/plugins/vite/meta.js

@@ -1,6 +1,7 @@
 import { loadConfig } from './config.js';
 import fs from 'fs';
 import { getPosterPath } from './poster.js';
+import { tryGetNeedleEngineVersion } from './utils.js';
 
 export const needleMeta = (command, config, userSettings) => {
 
@@ -15,7 +16,7 @@ export const needleMeta = (command, config, userSettings) => {
 
     return {
         // replace meta tags
-        name: 'needle-meta-tags',
+        name: 'needle-meta',
         transformIndexHtml: {
             enforce: 'pre',
             transform(html, _ctx) {
@@ -91,8 +92,19 @@ export const needleMeta = (command, config, userSettings) => {
                     }
                 }
 
-                // if(!tags.filter(t => t.attrs?.name === "generator"))
-                    tags.push({ tag: 'meta', attrs: { name: 'generator', content: 'Needle' } });
+                let generator = "Needle";
+                if (config.generator?.length > 5) {
+                    generator = config.generator;
+                }
+                tags.push({ tag: 'meta', attrs: { name: 'generator', content: generator } });
+
+                const needleEngineVersion = tryGetNeedleEngineVersion();
+                if (needleEngineVersion) {
+                    if (command === "build")
+                        console.log("Needle Engine version: " + needleEngineVersion);
+                    tags.push({ tag: 'meta', attrs: { name: 'needle-engine', content: needleEngineVersion } });
+                }
+                else console.log("WARN: could not find needle engine package.json")
 
                 return { html, tags }
             },
@@ -100,6 +112,7 @@ export const needleMeta = (command, config, userSettings) => {
     }
 }
 
+
 function updateUrlMetaTag(html, url) {
     html = html.replace(`<meta name="url" content="http://needle.tools">`, `<meta name="url" content="${url}">`);
     return html;

package/plugins/vite/utils.js

@@ -0,0 +1,11 @@
+import { existsSync, readFileSync } from "fs";
+
+export function tryGetNeedleEngineVersion() {
+    const needleEnginePackageJsonPath = process.cwd() + "/node_modules/@needle-tools/engine/package.json";
+    if (existsSync(needleEnginePackageJsonPath)) {
+        const json = JSON.parse(readFileSync(needleEnginePackageJsonPath));
+        const version = json.version;
+        return version;
+    }
+    return null;
+}

package/src/engine/codegen/register_types.js

@@ -54,6 +54,7 @@ import { ColorBySpeedModule } from "../../engine-components/ParticleSystemModule
 import { ColorOverLifetimeModule } from "../../engine-components/ParticleSystemModules";
 import { Component } from "../../engine-components/Component";
 import { ControlTrackHandler } from "../../engine-components/timeline/TimelineTracks";
+import { CustomBranding } from "../../engine-components/export/usdz/USDZExporter";
 import { Deletable } from "../../engine-components/DeleteBox";
 import { DeleteBox } from "../../engine-components/DeleteBox";
 import { DepthOfField } from "../../engine-components/postprocessing/Effects/DepthOfField";
@@ -126,7 +127,6 @@ import { PostProcessingHandler } from "../../engine-components/postprocessing/Po
 import { PreliminaryAction } from "../../engine-components/export/usdz/extensions/behavior/BehaviourComponents";
 import { PreliminaryTrigger } from "../../engine-components/export/usdz/extensions/behavior/BehaviourComponents";
 import { PresentationMode } from "../../engine-components-experimental/Presentation";
-import { QuickLookOverlay } from "../../engine-components/export/usdz/USDZExporter";
 import { RawImage } from "../../engine-components/ui/Image";
 import { Raycaster } from "../../engine-components/ui/Raycaster";
 import { Rect } from "../../engine-components/ui/RectTransform";
@@ -270,6 +270,7 @@ TypeStore.add("ColorBySpeedModule", ColorBySpeedModule);
 TypeStore.add("ColorOverLifetimeModule", ColorOverLifetimeModule);
 TypeStore.add("Component", Component);
 TypeStore.add("ControlTrackHandler", ControlTrackHandler);
+TypeStore.add("CustomBranding", CustomBranding);
 TypeStore.add("Deletable", Deletable);
 TypeStore.add("DeleteBox", DeleteBox);
 TypeStore.add("DepthOfField", DepthOfField);
@@ -342,7 +343,6 @@ TypeStore.add("PostProcessingHandler", PostProcessingHandler);
 TypeStore.add("PreliminaryAction", PreliminaryAction);
 TypeStore.add("PreliminaryTrigger", PreliminaryTrigger);
 TypeStore.add("PresentationMode", PresentationMode);
-TypeStore.add("QuickLookOverlay", QuickLookOverlay);
 TypeStore.add("RawImage", RawImage);
 TypeStore.add("Raycaster", Raycaster);
 TypeStore.add("Rect", Rect);

package/src/engine/engine_addressables.ts

@@ -353,7 +353,7 @@ new AddressableSerializer();
 
 
 
-
+const failedTexturePromise = Promise.resolve(null);
 
 export class ImageReference {
 
@@ -392,6 +392,7 @@ export class ImageReference {
 
     private loader: TextureLoader | null = null;
     createTexture(): Promise<Texture | null> {
+        if (!this.url) return failedTexturePromise;
         if (!this.loader) this.loader = new TextureLoader();
         this.loader.setCrossOrigin("anonymous");
         return this.loader.loadAsync(this.url);

package/src/engine/engine_constants.ts

@@ -1,3 +1,6 @@
+declare const NEEDLE_ENGINE_META: { version: string, generator: string };
+export const NEEDLE_ENGINE_VERSION = NEEDLE_ENGINE_META.version;
+export const NEEDLE_ENGINE_GENERATOR = NEEDLE_ENGINE_META.generator;
 
 export const activeInHierarchyFieldName = "needle_isActiveInHierarchy";
 export const builtinComponentKeyName = "builtin_components";

package/src/engine/engine_context.ts

@@ -29,6 +29,7 @@ import { CoroutineData, ICamera, IComponent, IContext, ILight } from "./engine_t
 import { destroy, foreachComponent } from './engine_gameobject';
 import { ContextEvent, ContextRegistry } from './engine_context_registry';
 import { delay } from './engine_utils';
+import { NEEDLE_ENGINE_VERSION } from './engine_constants';
 // import { createCameraWithOrbitControl } from '../engine-components/CameraUtils';
 
 
@@ -93,6 +94,11 @@ export function registerComponent(script: IComponent, context?: Context) {
 
 export class Context implements IContext {
 
+	/** the needle engine version */
+	get version() {
+		return NEEDLE_ENGINE_VERSION;
+	}
+
 	static get Current(): Context {
 		return ContextRegistry.Current as Context;
 	}

package/src/engine/engine_license.ts

@@ -7,7 +7,7 @@ const debug = getParam("debuglicense");
 
 // This is modified by a bundler (e.g. vite)
 // Do not edit manually
-const NEEDLE_ENGINE_LICENSE_TYPE: string = "";
+const NEEDLE_ENGINE_LICENSE_TYPE: string = "basic";
 if (debug) console.log("License Type: " + NEEDLE_ENGINE_LICENSE_TYPE)
 
 export function hasProLicense() {

package/src/engine/engine_serialization_core.ts

@@ -436,7 +436,7 @@ function implictlyAssignPrimitiveTypes(obj: any, serializedData: any) {
                 if (isPrimitiveType(data[key]) && !isPrimitiveType(member)) {
 
                     const prop = tryFindPropertyDescriptor(member, key);
-                    if (prop?.writable === false && (prop && prop.set === undefined)) {
+                    if (prop && (prop?.writable === undefined || prop?.writable === false) && (prop.set === undefined)) {
                         if (debug)
                             console.warn("Property is not writable \"" + key + "\"", member, prop, data[key], member[key]);
                         continue;

package/src/engine/engine_three_utils.ts

@@ -50,13 +50,13 @@ export function setWorldPositionXYZ(obj: Object3D, x: number, y: number, z: numb
 }
 
 
+const _worldQuaternions = new CircularBuffer(() => new Quaternion(), 100);
 const _worldQuaternionBuffer: Quaternion = new Quaternion();
-const _worldQuaternion: Quaternion = new Quaternion();
 const _tempQuaternionBuffer2: Quaternion = new Quaternion();
 
 export function getWorldQuaternion(obj: Object3D, target: Quaternion | null = null): Quaternion {
-    if (!obj) return _worldQuaternion.set(0, 0, 0, 1);
-    const quat = target ?? _worldQuaternion;
+    if (!obj) return _worldQuaternions.get().identity();
+    const quat = target ?? _worldQuaternions.get();
     if (!obj.parent) return quat.copy(obj.quaternion);
     obj.getWorldQuaternion(quat);
     return quat;
@@ -79,14 +79,16 @@ export function setWorldQuaternionXYZW(obj: Object3D, x: number, y: number, z: n
     setWorldQuaternion(obj, _worldQuaternionBuffer);
 }
 
+const _worldScaleBuffer = new CircularBuffer(() => new Vector3(), 100);
 const _worldScale: Vector3 = new Vector3();
-const _worldScale2: Vector3 = new Vector3();
 
 export function getWorldScale(obj: Object3D, vec: Vector3 | null = null): Vector3 {
-    if (!obj) return _worldScale.set(0, 0, 0);
-    if (!obj.parent) return _worldScale.copy(obj.scale);
-    obj.getWorldScale(vec ?? _worldScale);
-    return vec ?? _worldScale;
+    if (!vec)
+        vec = _worldScaleBuffer.get();
+    if (!obj) return vec.set(0, 0, 0);
+    if (!obj.parent) return vec.copy(obj.scale);
+    obj.getWorldScale(vec);
+    return vec;
 }
 
 export function setWorldScale(obj: Object3D, vec: Vector3) {
@@ -95,7 +97,7 @@ export function setWorldScale(obj: Object3D, vec: Vector3) {
         obj.scale.copy(vec);
         return;
     }
-    const tempVec = _worldScale2;
+    const tempVec = _worldScale;
     const obj2 = obj.parent;
     obj2.getWorldScale(tempVec);
     obj.scale.copy(vec);
@@ -109,6 +111,18 @@ export function forward(obj: Object3D): Vector3 {
     return _forward.set(0, 0, 1).applyQuaternion(_forwardQuat);
 }
 
+const _worldDirectionBuffer = new CircularBuffer(() => new Vector3(), 100);
+const _worldDirectionQuat = new Quaternion();
+/** Get the world direction. Returns world forward if nothing is passed in.
+ * Pass in a relative direction to get it converted to world space (e.g. dir = new Vector3(0, 1, 1))
+ * The returned vector will not be normalized
+ */
+export function getWorldDirection(obj: Object3D, dir?: Vector3) {
+    // If no direction is passed in set the direction to the forward vector
+    if (!dir) dir = _worldDirectionBuffer.get().set(0, 0, 1);
+    getWorldQuaternion(obj, _worldDirectionQuat);
+    return dir.applyQuaternion(_worldDirectionQuat);
+}
 
 
 const _worldEulerBuffer: Euler = new Euler();
@@ -119,14 +133,16 @@ const _worldRotation: Vector3 = new Vector3();
 
 // world euler (in radians)
 export function getWorldEuler(obj: Object3D): Euler {
-    obj.getWorldQuaternion(_worldQuaternion);
-    _worldEuler.setFromQuaternion(_worldQuaternion);
+    const quat = _worldQuaternions.get();
+    obj.getWorldQuaternion(quat);
+    _worldEuler.setFromQuaternion(quat);
     return _worldEuler;
 }
 
 // world euler (in radians)
 export function setWorldEuler(obj: Object3D, val: Euler) {
-    setWorldQuaternion(obj, _worldQuaternion.setFromEuler(val));;
+    const quat = _worldQuaternions.get();
+    setWorldQuaternion(obj, quat.setFromEuler(val));;
 }
 
 // returns rotation in degrees

package/src/engine/engine_utils.ts

@@ -408,4 +408,38 @@ export function isSafari() {
 
 export function isQuest() {
     return navigator.userAgent.includes("OculusBrowser");
+}
+
+
+
+const cloudflareIPRegex = /ip=(?<ip>.+?)\n/s;
+export async function getIpCloudflare() {
+    const data = await fetch('https://www.cloudflare.com/cdn-cgi/trace');
+    const body = await data.text();
+    // we are only interested in the ip= part:
+    const match = cloudflareIPRegex.exec(body);
+    if (match)
+        return match[1];
+    return null;
+}
+
+export async function getIp() {
+    const res = await fetch("https://api.db-ip.com/v2/free/self");
+    const json = await res.json();
+    return json.ipAddress;
+}
+
+export type IpAndLocation = {
+    ipAddress: string;
+    continentCode: string;
+    continentName: string;
+    countryCode: string;
+    countryName: string;
+    stateProv: string;
+    city: string;
+}
+export async function getIpAndLocation(): Promise<IpAndLocation> {
+    const res = (await fetch("https://api.db-ip.com/v2/free/self").catch(() => null))!;
+    const json = await res.json() as IpAndLocation;
+    return json;
 }

package/src/engine-components/AnimatorController.ts

@@ -408,7 +408,7 @@ export class AnimatorController {
                 }
             }
         }
-        else if (isDevEnvironment()) {
+        else if (debug) {
             if (!state["__warned_no_motion"]) {
                 state["__warned_no_motion"] = true;
                 console.warn("No action", state.motion, this);

package/src/engine-components/codegen/components.ts

@@ -52,6 +52,7 @@ export { ColorBySpeedModule } from "../ParticleSystemModules";
 export { ColorOverLifetimeModule } from "../ParticleSystemModules";
 export { Component } from "../Component";
 export { ControlTrackHandler } from "../timeline/TimelineTracks";
+export { CustomBranding } from "../export/usdz/USDZExporter";
 export { Deletable } from "../DeleteBox";
 export { DeleteBox } from "../DeleteBox";
 export { DepthOfField } from "../postprocessing/Effects/DepthOfField";
@@ -121,7 +122,6 @@ export { PointerEventData } from "../ui/PointerEvents";
 export { PostProcessingHandler } from "../postprocessing/PostProcessingHandler";
 export { PreliminaryAction } from "../export/usdz/extensions/behavior/BehaviourComponents";
 export { PreliminaryTrigger } from "../export/usdz/extensions/behavior/BehaviourComponents";
-export { QuickLookOverlay } from "../export/usdz/USDZExporter";
 export { RawImage } from "../ui/Image";
 export { Raycaster } from "../ui/Raycaster";
 export { Rect } from "../ui/RectTransform";

package/src/engine-components/export/usdz/USDZExporter.ts

@@ -18,7 +18,7 @@ import { AudioExtension } from "./extensions/behavior/AudioExtension";
 
 const debug = getParam("debugusdz");
 
-export class QuickLookOverlay {
+export class CustomBranding {
     @serializable()
     callToAction?: string;
     @serializable()
@@ -45,8 +45,8 @@ export class USDZExporter extends Behaviour {
     @serializable(URL)
     customUsdzFile?: string;
 
-    @serializable(QuickLookOverlay)
-    overlay?: QuickLookOverlay;
+    @serializable(CustomBranding)
+    customBranding?: CustomBranding;
 
     // Currently not exposed to integrations - not fully tested. Set from code (e.g. image tracking)
     @serializable()
@@ -66,6 +66,7 @@ export class USDZExporter extends Behaviour {
     private webARSessionRoot: WebARSessionRoot | undefined;
 
     start() {
+        console.log(this.customUsdzFile);
         if (debug) {
             console.log(this);
             console.log("Debug USDZ, press 't' to export")
@@ -249,16 +250,27 @@ export class USDZExporter extends Behaviour {
                     if (debug)
                         showBalloonMessage("Quicklook url: " + callToActionURL);
                     if (callToActionURL) {
-                        globalThis.open(callToActionURL, "_blank");
+                        if (!hasProLicense()) {
+                            console.warn("Quicklook closed: custom redirects require a Needle Engine Pro license: https://needle.tools/pricing", callToActionURL)
+                        }
+                        else {
+                            globalThis.open(callToActionURL, "_blank");
+                        }
                     }
                 }
             }
         }
     }
 
-    private buildQuicklookOverlay(): QuickLookOverlay {
-        const obj: QuickLookOverlay = {};
-        if (this.overlay) Object.assign(obj, this.overlay);
+    private buildQuicklookOverlay(): CustomBranding {
+        const obj: CustomBranding = {};
+        if (this.customBranding) Object.assign(obj, this.customBranding);
+        if (!hasProLicense()) {
+            console.log("Custom Quicklook banner text requires pro license: https://needle.tools/pricing");
+            obj.callToAction = "Close";
+            obj.checkoutTitle = "🌵 Made with Needle";
+            obj.checkoutSubtitle = "_";
+        }
         if (!obj.callToAction?.length)
             obj.callToAction = "Close";
         if (!obj.checkoutTitle?.length)

package/src/engine-components/ui/Graphic.ts

@@ -174,7 +174,6 @@ export class Graphic extends BaseUIComponent implements IGraphic, IRectTransform
     static textureCache: Map<Texture, Texture> = new Map();
 
     protected async setTexture(tex: Texture | null | undefined) {
-        if (!tex) return;
         this.setOptions({ backgroundOpacity: 0 });
         if (tex) {
             // workaround for https://github.com/needle-tools/needle-engine-support/issues/109
@@ -190,6 +189,9 @@ export class Graphic extends BaseUIComponent implements IGraphic, IRectTransform
             }
             this.setOptions({ backgroundImage: tex, borderRadius: 0, backgroundOpacity: this.color.alpha, backgroundSize: "stretch" });
         }
+        else {
+            this.setOptions({ backgroundImage: null, borderRadius: 0, backgroundOpacity: this.color.alpha });
+        }
     }
 
     protected onAfterAddedToScene(): void {

package/src/engine-components/ui/Text.ts

@@ -61,10 +61,11 @@ export class Text extends Graphic {
     }
 
     set text(val: string) {
-
-
-        this._text = val;
-        this.feedText(this.text, this.supportRichText);
+        if (val !== this._text) {
+            this._text = val;
+            this.feedText(this.text, this.supportRichText);
+            this.markDirty();
+        }
     }
 
     private set_text(val: string) {

package/src/needle-engine.ts

@@ -1,6 +1,8 @@
 import { makeErrorsVisibleForDevelopment } from "./engine/debug/debug_overlay";
 makeErrorsVisibleForDevelopment();
 
+import { NEEDLE_ENGINE_GENERATOR, NEEDLE_ENGINE_VERSION } from "./engine/engine_constants";
+
 import "./engine/engine_element";
 import "./engine/engine_setup";
 import "./engine-components/CameraUtils"
@@ -9,6 +11,7 @@ export * from "./engine/api";
 export * from "./engine-components/api";
 export * from "./engine-components-experimental/api";
 
+
 // make accessible for external javascript
 import { Context } from "./engine/engine_setup";
 const Needle = { Context: Context };
@@ -27,6 +30,12 @@ registerGlobal(Component);
 import * as Components from "./engine-components/codegen/components";
 registerGlobal(Components);
 
+Needle["$meta"] = {
+    version: NEEDLE_ENGINE_VERSION,
+    generator: NEEDLE_ENGINE_GENERATOR
+};
+
+
 import { GameObject } from "./engine-components/Component";
 for (const method of Object.getOwnPropertyNames(GameObject)) {
     switch (method) {
@@ -50,4 +59,4 @@ else console.warn("Threejs is already imported");
 
 
 
-import "./engine/engine_license";
+import "./engine/engine_license";